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HOW TO GET 
OVER $2000 WORTH OF NEW 
CAPABILITIES FOR YOUR 
COMM< 




OR $599 



The Spartan'" is the Apple'" II + emulator for your Commodore 64'" that will open 

up a whole new world of hardware and software for youl Imagine adding these 
features to your Commodore 64'" for the Spartan'" price of S599: Q Apple'"" + 
hardware and software capabilities □ 64K RAM expansion D four 
software selectable Commodore 64'" cartridge slots □ non-dedicated 8-bit 
parallel port □ standard audio cassette deck capabilities for your C-64'". 
The suggested retail value of comparable products offering only these 
capabilities is over $2200.00* — but the Spartan'"* gives you much, much 
morel By building on your investment in your Commodore 64'" — an 
excellent introductory computer — you create a whole new system 
with both C-64'" and Apple'" ll-l- capabilities. There is a whole other 
world out therel The huge selection of Apple'" II + hardware and 
software is now yours to explore! Call toll free for the Spartan'" 

dealer nearest you. ^ 



FOR INFORMATION WRITE: 

MIMIC SYSTEMS INC. 
1112 FORT ST., FL. 6L 



•All piiees Quoled ore In U S. hurts, rroight ontj taxes nor Included. Value ol compooenii equivalent 
to Itw SpQi(on~ jystam ore quoled from Apple" II + CPU and Apple" II + single disk drive 1»(J 
list ptlcei, and ttom cutrwit suggesied list prices ond component specllicotlons o( oltier 
pailpheral monufoclurorJ. Commodofe 64- and Commodore logo are trademarks ot 
Commodore Eleolioolci ltd- and or Commodore luslness Moctiines. Ine. Apple" in- Is a 
nodemarti ot Apple Computer Inc. Sporton- Is o trademark of Mimic Systems inc. and tioi 
no osioclatioo v^im Commodore Eleclronles or Apple computet Inc. Jtie Spartan- Is 
monutoctured by Mimic Syslemj inc. under license gronled by AIG Electronics Inc. 0( 

Victoria, B.C. Canada. 
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BUG and CBUG 

We have received word from Norman 
Deltzke, president of the Chicago B-128 
Users' Group (CBUG), that the national 
B-128 User Group (BUG) is no longer in 
operation, and that its director. Marl in 
Schwanke, is no longer attempting to 
operate the group or publish the newslet- 
ter that he had founded. Because of this, 
we must now advise you to Twt send away 
membership fees to the address we gave 
for BUG in our December 'Bulletin 
Board' section — there is apparently no 
longer anything to send away for. 

CBUG, in contrast, is thriving, and 
looks like an important source of infor- 
mation and support for B-128 users. The 
club now claims about 2000 members in 
the US, Canada, Australia, New Zealand, 
England, Sweden, Germany, Italy and 
other countries, and a heavy publishing 
schedule. Activities include local 
meetings in the Chicago area, and sup- 
port via telephone and newsletter for 
members elsewhere. CBUG's mailing ad- 
dress is: 

CBUG 

c/o Norman Deltzke 
4102 N. OdeU 
Norridge, fllinois 60634 

Membership fees are $10.00 (US) a yea?. 

This month 

This month's feature on the Commodore 
128, and particularly its CP/M mode, is 
largely the work of Adam Herst and 
Miklos Garamszeghy, two Toronto-area 
authors who see outstanding potential in 
this most versatile of 8-bit machines. 
Look for more articles on the 128 from 
Adam and Miklos in issues to come. 

While we're talking about the C-128, 
owners of the 1571 disk drive will want 
to know of the following DOS bug, which 
we just saw reported in the latest copy 
if Info magazine. Look there for details 
but, briefly , the problem arises when you 
attempt to validate, in 1541 mode, a disk 
that was formatted double-sided in 1571 
mode. After this operation, the 1571 
mode will no longer recognize that your 
disk is double -sided, and unless you rec- 
tify the misunderstanding right away, 
you will in the course of subsequently sav- 
ing and loading files become the proud 
owner of an irretrievably corrupted disk. 

2 TPUG Magazine 



The fix, if you find yotirself in this situa- 
tion, is to use a direct access command 
to write $80 (decimal 128) to byte 4 of 
track 18, sector 0. Info provides a short 
program to do this job for those who can't 
manage it on their own. ' ' 

Blank disks 

Due to a hardware glitch in one of the 
4040 disk drives, a number of blank disks 
were sent to members. The problem has 
since been corrected, but anyone who 



received one of these disks can get a free 
replacement by mailing or telephoning 
their name, address, and membership 
number to the TPUG office. 

Amiga feedback problem 

TPUG is looking for member feedback on 
the establishment of an Amiga chapter. 
Any person interested in becoming a 
coordinator for this chapter should con- 
tact Bruce Hampson, General Manager, 
at the TPUG Office. 

The editors D 



The state of TPUG 



Much has happened at TPUG in the past three months. Perhaps most impor- 
tant has been the installation of a new computer system. This IBM -compatible 
system allows us much faster access to our 18,000 membership files and records, 
and allows us to keep better control over our orders. With the new system, we 
need less staff to give our members much better service with fewer problems. 

Our finances are in great shape, and we are on a sound foundation with some 
innovative programs coming up. We have purchased some new office equipment 
and systems and are embarking on a new membership drive. Membership is grow- 
ing again, and more and more associate clubs are joining us. We have also 
straightened out most of the complaints and problems. 

One problem we are still having is with our software library. Major changes 
are being worked on in that area, including the acquisition of a high-speed disk 
duplicator, and a reworking of the disk cataloguing system. The Disk of the Month 
subscription series was even more successful than we had hoped, which led, 
ironically, to more problems. These are now almost completely solved. 

One of our new staff members, SaEy Murciano, is working almost exclusively 
on associate clubs. With more than 65 clubs and 3000 of our members included 
in this category, we have decided to spend even more time and resources on 
this section. If you are a member of a users' group not yet affiliated with us 
directly, write to Sally for more details. We can offer you a considerable sav- 
ings on membership as well as some other great benefits. 

We have had a number of problems lately with cheques and correspondence 
from our members. Please remember to include you membership number on both 
your letter and cheque. This is especially important for people who hand -write 
their letters instead of typing them. Sometimes signatures are hard to decipher, 
and without you membership number we have no way of getting back to you. 

We would also appreciate it if you would not post-date cheques. These are very 
confusing and cause us great problems. If you must post-date, then please make 
sure that they are well mai-ked (perhaps in a different colour) to show us. Some 
days we might process 500 cheques, and often these get through the system 
before the bank catches them. 

We also appreciate the number of letters we have received expressing your 
support for us. We have just come through some difficult times with flying col- 
ours, and your understanding and patience have been most appreciated. Now 
that we have most things settled, we look forward to serving you even better. 

Bruce Hampson 

TPUG General Manner D 
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Amiga skepticism 

Your articles on the Amiga seemed par- 
ticularly directed to people who like to 
simply fool around with computers: as 
one of those very people, I'd like to tell 
you about my first two weeks of Amiga 
ownership — its joy and its frustration. 
The sound and colour are both substan- 
tially better than anything else I've 
played with and, in particular, the 
tremendous voice capability is worth 
hours of exploring its possibilities. 
Beyond that, my initial reactions have 
been negative. Most of my frustration 
results from not having any documenta- 
tion on the machine — something that 
will, I suppose, be cured in time. Here I 
live in the shadow of the Company itself, 
know some of the employees, and get con- 
stant assurances that the documentation 
is available. The hard fact is that I can't 
get it, and have spent much of the past 
two weeks unsuccessfully trying to con- 
nect my printer, program the function 
keys, transfer files from one disk to 
another, or get into the fabled high- 
resolution mode — the kind of thing that 
was readily done on the C-64 because it 
came with a Programmer's Reference 
Guide. The absence of an equivalent 
volume makes the Amiga unready for 
marketing to programming buffs, and the 
total absence of software makes it 
unready for other users. 

A big disappointment is the editor built 
into ABasiC, It is 1982 state-of-the-art, 
lacking the friendliness and power of 
even our present-day editors, let alone 
the bold new future promised by the 
advertising hype. Another disappoint- 
ment is the slowness with which it starts 
up. Kick-starting is the way it was done 
in 1975 — there are better ways available 
now. 



Much is made of the graphics capabili- 
ty of the Amiga, Its ABasiC commands 
have some new scope but they are not as 
powerful as I expected, not at all revolu- 
tionary, and not nearly so good as those 
of the Macintosh. Mostly, new names 
have been given to old graphics com- 
mands, and the clumsiness of standard 
plotting routines has been retained. I was 
hoping for, and will probably get in the 
future, a substantially easier system for 
manipulating the screen display. 

My advice to TPUG readers is, Don't 
Throw Away Your C-64! The Company 
may make more money changing models 
all the time, but hackers lose by it. We 
will get more return on our effort by stay- 
ing with one model, continuing to build 
up our library of software and a ware- 
house of hardware attachments to fit that 
model. I strongly feel we users should do 
whatever is necessary to encourage Com- 
modore to continue supporting the C-64, 
and do what we can to counter the trend 
among merchandisers to dump it in 
favour of these new models. The advan- 
tages claimed for the new models simply 
do not justify abandoning our C-64 soft- 
ware and hardware. 

Deep in every hobbyist there always 
lurks a strong urge to get something 
newer and better, an urge that usually 
gets expressed as updating to some 
newer model . Loss of compatability is a 
terrible price to pay — let me suggest that . 
an alternative way to satisfy this craving 
is to go in for peripherals. Add on voice 
control and voice generation. Add on a 
hard disk drive. Keep your C-64 as the 
core of your system and connect up a 
video camera so it can see as well as hear 
and talk. If you don't already have a 1520 
plotter, get one — it's marvellous (and 
also on the endangered list, like the C-64 
itself). 

Let's mount a campaign to promote 
enhancements for the C-64 rather than 
replacements. Save the C-64! 

Walter Stauber 
Springfield, Pennsylvania 

You're right — Amiga documentation is 
hard to come by. But let's not be too 
nostalgic for the good old days of the Com- 
modore 6U — the Programmer's 
Reference Guide did not cmne with the 
machine, but had to be purchased 



separately, just like the documentation for 
the Amiga. Nor was it available 
simultaneously with the 64 's release. 

Another point on the same subject: the 
6i's Reference Guide was good, par- 
ticularly by the Commodore standards of 
yesteryear, but it wasn't perfect. How 
much of what you know about the 6If came 
from magazinx, articles published over the 
last three or four years, how much from 
Jim Butterfield's memory maps, how 
much from other hooks? It will admitted- 
ly take a long time before we'll see that 
quantity of information for the Amiga, 
but this is true of any new machine. And 
though they are stUl in short supply. Com- 
modore's progamming manuals for the 
Amiga are both comprehensive and detail- 
ed. With such a complex machine, that 
means a lot of docmnentation — and swne 
of it is even comprehensible. 

ABasiC is a dead language now, of 
course, which no one is lamenting. 
Microsoft's AmigaBasic is vastly 
superior, and ftas a full screen editor too. 
Sure, you have to load it in from disk in- 
stead of having it pop up instantly when 
you switch on your machine, but there are 
some small compensations. For instance, 
try writing a 1200-baud terminal pro- 
gram in BASIC on the Commodore 6i. 
You can do it in half a screen in 
AmigaBasic. How about a graphics 
package, with lines, circles, boxes and 
area fills, and with a screen resolution 
equal to the 6i 's hi-res mode, but with 16 
colours instead of two? I've seen three or 
four such prograTns already on the 
Amiga, and they all have two things in 
common: they're fast, and they're short. 

And here's something you didn't men- 
tion — multitasking. Until you've used the 
Amiga for a while, it 's difficult to ap- 
preciate just how convenient the multi- 
tasking can be. The, ability to skip back 
and forth between programs without hav- 
ing to shut any of them down is something 
you'll eventually take for granted — and 
you'll feel strangled when you have to go 
back to a single-task machine. The 
graphics and the sound are nice — spec- 
tacular even, by the standards of most 
computers — but I think it's the multitask- 
ing that will have the profoundest effect 
on hackers and users alike. 

Throw away your Commodore 6ii ? No, 
absolutely not. There are tirnes when the 
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straightforwardness of the 64 's user inter- 
face is just what you want and need — and 
of course, you've got all that software. But 
don't give up on the Amiga, either. It isn't 
perfect but, in a lot of ways, it's the best 
there is. 

Nick Sullivan 

On copy protection 

I have been a Commodore computer user 
and a member of TPUG for several years 
now, and I have enjoyed both the com- 
puters and my memberships in TPUG. I 
have been quite disturbed by the past 
several issues of TPUG Magazine, and in 
particular by the November 1985 
editorial. 

The trend that has disturbed me is 
TPUG's apparent support of copy protec- 
tion. While I am certainly not in favour 
of software theft (a term I prefer to 
piracy, which has certain romantic over- 
tones), I am equally opposed to copy pro- 
tection of software. 

In particular, the last issue's editorial 
equated programs designed to copy or 
"break' protected disks with 'piracy tools'. 
This implies, I suppose, that owners of 
these programs are in fact pirates, and 
magazines that advertise them are 
advocating piracy. 

While it is true that these programs 
could be used for such illegal purposes, 
to call them 'piracy tools' is absurd. It is 
the same as calling people who own 
modems and terminal software 'computer 
criminals', since modems and terminal 
software are indeed necessary tools for 
anyone desiring to break into a system. 
Most owners of such equipment have pro- 
bably never even tried to do such a thing, 
just as most owners of 'copy busting' pro- 
grams are probably not pirates. 

While I am not familiar with Canadian 
law, the copyright laws in the US give the 
original purchaser of a program the legal 
right to an archival copy. Copy protection 
attempts to deny this right to the legal 
purchasers, and copy -busting programs 
attempt to give it back. Consider some- 
one who makes his living as a writer, and 
uses the computer as a tool of the trade . 
Only a fool would use a program that 
could not be backed up — deadlines could 
be missed, et cetera. 

As personal computers grow more 
powerful — and Commodore computers, 
in particular, have grown enormously in 
power with the introduction of the C-128 
and the Amiga — copy protection 
becomes increasingly less desirable. 
Many owners of Ajnigas and 128's will 
undoubtedly wish to purchase hard disks. 
I do not envy these individuals their 
future attempts to move copy-protected 



software over to a hard disk. Amiga 
owners may wish to run concurrently two 
or three programs. Copy protection often 
involves replacing the DOS code with 
code from the protected programs — 
what is going to happen when the BCD 
word processor tries to change the code 
already installed by ACME spreadsheet? 
Several scenarios spring to mind, involv- 
ing things from smoke to destroyed disks, 
lost data, and grey hairs. 

The current trend is clearly anti-copy 
protection. A large number of software 
houses have announced that they have 
dropped copy protection on all of their 
products, due to the hardship forced upon 
their users. Publishers of software such 
as Borland (Turbo Pascal) have proven 
that copy protection is not necessary to 
a successful software business. Other 
publishers (such as Sirius Software) have 
demonstrated that copy protection does 
not ensure success by copy protecting 
their software and entering Chapter 11. 

I would submit to you that, given the 
choice, most people would choose a non- 
protected program over a protected one. 
I would also suggest that there is strong 
evidence that the tide is turning against 
protection, both by legitimate users and 
legitimate software publishers. I would 
further suggest that without copy protec- 
tion, 'copy -busting' programs would not 
exist. It seems to me the course of action 
is clear — if you really wish to stamp out 
these piracy tools, help your users, and 
remain in the forefront of the computer 
revolution (which TPUG always has), you 
should refuse to advertise any protected 
software, and advertise instead only the 
copy-busting programs. 

Consider — if all magazines had this 
policy, in order to bring their products to 
the attention of the public, software 
houses would have to drop the protection 
on their products. This, in turn, would 
cause the Copy Buster programmers to 
go out of business, or turn to other pro- 
ducts: what good is a copy-busting pro- 
gram when there is nothing to bust? Peo- 
ple would be able to move programs to 
their hard disks without worry, Amiga 
owners would be able to multitask to their 
heart's content, and the software 
publishers would whistle all the way to 
the bank. 
Scott Ballantyne 
New York, New York 
/ ugree that the trend atrwng software 
publishers is away from copy protection, 
particularly on software directed at the 
new machines, and I too am glad that it 
is so. Nor do I personally oppose the mak- 
ing of archival backups of protected soft- 
ware, or utilities that make this possible. 



But copy protection, with all itsfaidts, is 
not a conspiracy cm the part of software 
publishers to make life difficult for com- 
puterists, however common that side-effect 
muy be. And it is a response to piracy 
(though perhaps, idtimately, a misguided 
and self-defeating one), not the cause. 

Early, unprotected, commercial pro- 
grams suffered widespread illegal 
duplication. It was not unnatural for the 
software manufacturers to seek methods 
of ensuring that the users of their products 
were also paying customers. Copy- 
protection is one of those methods; another 
one is the use of copious documentation, 
since information is far less convenient- 
ly copied when it comes in printed rather 
than magnetically-encoded form. The lat- 
ter Tnethod is becoming more popular as 
the software itself becomes more complex: 
it is significant that most of those com- 
panies that do not use copy-protection are 
those whose products require heavy doc- 
umentation; whereas games manufac- 
turers, for instance, have been slower to 
abandon what for them is their only 
mea-ns of defence. It may be that it imU one 
day be possible to abandon protection, 
along with such other inconveniences as 
locks on doors, border guards, and access 
codes for banking machines; Tneanwhile, 
we have to accept that we belong to a soci- 
ety that views all these impediments to 
civilized living as necessary and normal. 

Let us set aside the question of legal 
rights, for surely there are conflicting 
rights here — ours to copy, the publishers' 
to protect — and agree that there is a case 
for copy-protection, whether or not it is 
finally convincing. How do the publishers 
ofdeprotection software fit into the scheme 
of things, and how do they present their 
products? Very often with an overt appeal 
to the romantic image of piracy you decry. 
Have you seen thefull^page colour ads for 
a product called The Shadow? It is not 
directed at the freelance writer who needs 
a security backup of a word processor. 

What amazes me about the magazine 
ads for deprotection utilities is not their 
existence, but their quantity. The fact that 
this rather arcane specialty is so prolific 
and so vigorous can't be unrelated to the 
huge amount of illegally-cloned software 
available in every schoolhouse and every 
corporate office-building. It may be thcU,, 
by refusing ads for these utilities, TPUG 
has abstained from the battle against 
copy-protection; it may also be that 
magazines that accept such ads are put- 
ting the ability to pirate software within 
reach of the mass of consumers, rather 
than just the ingenious few. 

Nick Sullivan 
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// ijtju have a qttestioii. for The 
Answer Desk, write to us at: 

Answer Desk 

TPUG Magazine 

101 Duncan Mill Road, Sidle G7 

Don Mills, Ontario MsB IZS 

Canada 



C-64 Meets Waterloo 

/s Waterloo BASIC availabkfor the C-6J, 
and, if so, where can I get it? 

Joseph Srdarev 
Etobicoke, ON 

Yes, Joseph, it is. Waterloo Structured 
BASIC is in wide use on PETs, and is 
part of the curriculum in many schools 
and community colleges. It is favoured by 
educators, since its structured program- 
ming statements encourage the writing 
of more readable programs that are much 
easier to maintain (and to grade!). 
Subroutines take the form of named pro- 
cedures that can be CALLed by name. It 
also includes commands such as AUTO, 
DELETE and RENUMBER, which are 
very helpful editing tools. You can order 
it from: 

WATCOM Products 
415 Phillip Street 
Waterloo, ON 
N2L 3X2 
(519) 886-3700 

The software is on cartridge, and the 
package includes a comprehensive te.xt- 
book containing both a primer and a 
reference manual WATCOM also offers 
seminars on BASIC and WATCOM 
Pascal. Call or write for pricing 
information. 

Fade-in diagnosis 

Sometimes vjken I switch on my C-6U 
system, the blue Commodore screen 
doesn't appear on my monitor — it's 
definitely on, but the screen is a blank 
dark grey. After several uyisuccessful at- 
tempts, there will come a time when the 
regular blue Commodore screen a/;tually 
fades on after a few nwTnents. Sometimes 
it does7i't, and I just let my computer 'cool 
down' for a few hours. After that time, it 
switches on fine. I feel the problem is the 



computer, not the monitor. No one I have 
talked to can tell me what's wrong (if 
ariything). Your help would be 
appreciated. 

M. Kanas 

Mount Albert, Ontario 

Intermittent problems are the hardest to 
diagnose and to fix. My guess is that your 
problem is a faulty power supply. Try 
another power supply, if you have access 
to one, and see what happens. If that pro- 
duces the same result, you'll have to in- 
vestigate further. You can isolate the 
faulty component in your system if you 
proceed step by step. 

First, disconnect your 64 from the 
monitor and hook it up to your TV, us- 
ing the cable and RF modulator that 
came with the 64. If you still have the pro- 
blem, it is definitely the computer itself, 
and you should have the VIC II chip 
checked. Lf the 64 works fine with the TV, 
reconnect the monitor, but this time try 
the inputs on the front of the monitor in- 
stead of the back (or vice versa if you've 
been using the front ones). If you still 
have the problem, try a different video 
cable. The last link in the chain is the 
monitor itself. Try a different monitor, 
or try using your monitor with a VCR. 
Somewhere in the course of all this, the 
offending item will be revealed. Although 
this process of replacing components and 
trying different things can be tedious and 
time-consuming, it is almost always effec- 
tive for ferreting out 'gremlins'. 
Ba^k in the August/September issue, I 
gave the name and address of Cynthia 
Wood (HHB 33d AADCOM CMR 2122. 
APO, New York 09 175) who has offe)-ed to 
be a resource for the Answer Desk. Cyn- 
thia's specialty is Super base. She has 
since fielded several Superbase enquiries, 
which are reproduced here along urilh her 
answers. Thanks a bt, CynthiaJ 

Railroad management 

I have been using Superbase 64 for a 

variety of address lists, and find it very 
valuable. However, I would like to use it 
to run my model railroad pass list on, but 
it would appear that you can't have' a 
combination 'Key list' and 'Number list'. 
Or can you? If you can, how would it be 
arranged? I would like to have the pass 
numbers (001 on up) as the first item, 
followed by name, address and the like. 
I would also like to take the pass list and 



use it to put the names and so on in 
alphabetical order. Is this possible? 

S. Richard Knotts 
Wheaton, Maryland 

Jfl understand your question correctly, 
Superbase will readily handle your pro- 

blem. You may choose either the Number 
field (001 and so on) or the Name field to 
be your Key field. This will depend on the 
order in which you want the records to ap- 
pear when you are working with the file 
on-scree)i (as opposed to outpidting to 
pointer or creating reports) — mainly 
entering and editing your file. If the 
Number field is the Key field then your 
records urill be in numerical order. If 
your Name field is the Key field, they will 
be in alphabetical order. The Key field 
does not have to be the first field of the 
record. 

If you choose the number field to be your 
Key field, follow this procedure for 
creating an alphabetical 'key list' for out- 
put and report ^ises (see sectio7i 10 in the 
Reference section of the User's Manual): 

1) From Menu 2, press f4 to choose the 
Sort option 

2) Type: all on [name] to "halphlist" 

Put the name of your Name field in the 
brackets and call the list (in quotes) 
anything you ivant. Start it with an h if 
you want to be able to mew the list with 
the Help option, and end it with the word 
list to prevent accidentally writing over 
other files by choosiitg an identical name. 
This is a good habit. I use -base, -list, - 
export and similar file-type suffixes to 
prevent accidental erasures. Files within 
a database are the only things that I don't 
give an ideiitifier. 

3) Press return. Superbase wiU create an 

alphabetical list of your files. Viewing it 
with the Help option will display the 
numbers of each record. To see the records 
in the keylist, use the Output option: 

la) From Menu 1, press 14 

2a) Type: from "halphlist" (number] 

[name] [address] [state] 

The brackets enclose your field names. 
These may be omitted, in which case all 
fields will be listed, or any number of 
fields may be chosen for vietdng. Also, the 
word down (as in down from 
"halphlist") may be inserted to display 
the fields in a column instead of across. 
Down and across remain in effect until 
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the other is specified. The same goes for 
display and print, which select the screen 
and the printer respectively. 

Sal Press return and watch your records 
turn up alphabetically on the screen 
ia) Output to printer by using print 
from. . . in step 2a above. 

There is another interesting feature of the- 
Sort option that allows you to create a list 
in descending numerical or reverse 
alphabetical order. Simply insert a D- in 
the sort coinmand (step 2 above becomes 
all D- on. . .). Your sorts can also be 
layered (alphabetical first names within 
alphabetical last names, for example) by 
specifying more than one field in the sort 
command. 

Output hangup 

I have two questions: 

1) When I wish to print out a list or 
report to my printer, I'll get a few lines 
of the data and then the printer stops. 
The disk will continue to spin, but nothing 
is output to the printer. I get out of it by 
disconnecting the printer, I end with an 
'I/O 5' error. I am using a Cardco +G in- 
terface, with transparent mode on and 
auto LF off. I use 'dev 4, pdef 5'. Can you 
give me any hints as to what my problem 
may be and possible measures to correct 
it? 

2. When loading a database, the screen 
shows the database catalog of files. When 
I wish to scratch a file, I enter the Main- 
tain menu, then use the other option to 
scratch the filename from the disk (which 
does happen). My problem is that the 
filename remains in the Database 
Catalog, even though the file itself is 
gone. How do I remove it? 

Matthew Brown 
Chilli wack, BC 

1) I tried to duplicate the problem and it 
refused to be a problem. I have a Gemini 
lOX printer and the same interface. I nor- 
mally have the transparent mode off (in- 
terface dip switch seven on) but I turned 
it on (SW7 ojf) to match your set-up. Keep- 
ing auto LF off (my usual mode) I chang- 
ed the pdef to 5 (I normally use 0), and still 
came up with no printing problems. You 
did not say which printer you have. I 
would suggest you try turning the 
transparent mode off and using pdefO. If 
that doesn't work, I don't think I can help. 
By the way, the 'I/O 5' is a Kemal Tnessage 
meaning 'Device Not Present', which real- 
ly tells you only what you, already know: 
that there has been a catastrophic 
breakdown in communications between 
the computer and the printer. 

2) To delete a file you must first delete all 



records (with d on the Select m£nu, con- 
firming each deleted record with y). Then 
from the main menu, type select delete 

to delete the file. The filename should now 
no longer be in the catalog, and you can 
delete the file from the disk. 

Sort with duplicate l<eys 

I have an address list with an added 
numerical field, and I would like to have 
a printed list in numerical order. When 
I attempted to sort on the numeric field, 
I ran into a problem that I had experienc- 
ed before when using the sort option: 
some numbers are printing out of order. 
When the print routine accesses the 
record, it does so by the key, and in this 
case looks for the first Smith that it has 
available. Because there are several 
Smiths, the one it grabs may not have the 
proper number . Do you know of any other 
way around this problem? 

Bob Adler 

Kenil worth, New Jersey 

Here is a program that will enahle you to 
print your pass list numerically. It will 
probably be a very slow process but it 
works. The manual leads me to believe 
that there is another way: Section i.1.4, 
page R-20, says to devise a program us- 
ing Select Next, but I don't think it's 
possible to Select Next when outputting. 
We would have to be able to stop the out- 
put process to check each record to make 
sure it is, indeed, the Smith we want (us- 
ing If/then), and selecting the next record 
if it isn't. 

10 rem sort on number field 

with duplicate keys 
30 rem for screen display a 
dd "§1,n" before first f 
ield in line 230 
100 ask i4,4''Enter total nu 

mber of records '';r 
110 print g30"PASS LIST" 81 
"No." ee "Name" 835 "Ad 
dress" 860 "City" 
190 n=0:n1$="'' 
200 n=n+1 :n1$-str$( n) :if n< 
10 then n$="00"+right$t 

m$,i] 

210 if n>9 then n$ = ''0"+righ 

t$Cn1$,2) 
21B if n>99 then n$=right$( 

n1$,3) 
220 select match where [ num 

ber] is nf 
230 print [number] & [first 

names] C [ lastname] 830 

C [address] 855 [town] 
240 select last 



250 if n=r then display:men 

u 
300 goto 200 

Lines 200 and 210 setup a variable based 
on the number n, which is increased by 
one each time through. Ifn is less than 10, 
it must be preceded by two Os; if greater 
than 9, by only one. The right$ function 
eliminates the space resemedfor the sign 
of a number variable so thai n$ won't be 
"00 1 ". Line 2JtO insures that each search 
will begin at the beginning of the file. D 
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Getting Started With CP/M 



by Adam Herst 

Copyright ® 1986 Adam Her si 

In their advertising, Commodore com- 
pares the C-128's 'higher intelligence' 
with the fallen fruits of the Apple or- 
chard. Unfortunately, Commodore forgot 
to include in their comparisons one of the 
C-128's most powerfiil features, a Z80 
microprocessor and its accompanying 
operating system, CP/M, This feature 
makes the C-128 one of the lowest-priced 
entries into the ranks of dedicated 
business computers, and opens up a pro- 
gramming environment never before 
seriously implemented on Commodore 
computers. 

In CP/M mode, you have access to 
CP/M Plus, the latest version of CP/M: 
the same operating system that controls 
countless other computers from a varie- 
ty of manufacturers. Previous versions of 
CP/M are compatible (with restrictions) 
with CP/M Plus and a large base of pro- 
grams exists: from languages to utilities, 
databases to wordprocessors, available 
both commercially and from public do- 
main libraries. Using these programs re^ 
quires little if any knowledge of CP/M 
other than how to get your system set up. 
This article will cover the basics of set- 
ting up CP/M on the C-128, and will tell 
you how to extract a forty page Help 
manual from your CP/M systems disk. 

What is CP/M? You cai>think of CP/M 
as an extremely sophisticated and power- 
ful DOS wedge. Its primary purpose is to 
manipulate, and maintain status informa- 
tion about, the physical devices that make 
up your system, the disks the system is 
operating on, and the files that are on 
those disks. A bonus is the inclusion of 
all the tools necessary for a complete 
assembly language programming 
environment. 

Physical devices 

Most CP/M systems consist of a computer 
running CP/M and at least one disk drive. 
CP/M on the C-128 can support multiple 
disk drives (almost a necessity), and up 
to two printers. If you've used more than 
one disk drive on a CBM machine before, 
you are probably aware that they can sup- 
port up to four disk drives assigned 
device numbers 8 through 11. CP/M mode 
mimics this setup and supports up to four 



physical drives assigned device letters A 

through D. To set up a multiple-drive 
system, you must change drive device 
numbers through hardware, or through 
software from C-128 mode, 6c/ore booting 
the CP/M system. After the system has 
booted, drive 8 becomes drive A, drive 9 
becomes drive B, and so on. 

Two drives are recommended since 
CP/M involves a lot of disk and file shuf- 
fling. If you do not have two or more 
drives, don't worry — CP/M on the C-128 
is configured to provide a virtual drive 
available to everyone regardless of the 
number of physical drives attached to the 
system. This drive is designated as drive 
E. The use of drive E won't save you the 
disk switching, but it will make copjnng 
files and running multidisk programs 
possible. 

Booting the system 

Unlike the BASIC operating system in 
128 mode, which resides in ROM, the 
CP/M operating system must be loaded 
into memory from disk. There are two 
ways to boot the CP/M system on the 
C-128. 

If you are using a single drive or multi- 
ple drives assigned different drive 
numbers through hardware, you can boot 
the system by inserting the systems disk 
in drive 8 with the computer off and the 
drive on. Once the disk is inserted, turn 
on the computer and CP/M will autoboot. 

If you are using multiple drives that 
need their drive numbers changed 
through software, first change the drive 
numbers from 128 mode. After this has 
been done, put your systems disk in drive 
8 and type BOOT, CP/M will boot and 
take control of the system. If you try to 
boot CP/M by using the reset button , you 
will only succeed in resetting the drives. 

In both cases, a successful boot is in- 
dicated by the CP/M ready prompt, A> , 
and a flashing cursor. 

As mentioned, CP/M's primary purpose 
is to provide status information about 
your system. One way it does this is 
through the prompt. The A> prompt 
tells you that your primary drive is drive 
A. This is the drive that will be accessed 
unless you tell the system otherwise. If 
you are using a multiple drive system, you 
can change the primary drive designation 
by typing the new primary drive letter 
followed by a colon at the prompt. To 



change the primary drive to drive B, type 
B: < RETURN > at the prompt. 

CP/M expects you to type in commands 
at the prompt. Commands are files that 
reside on disk with the file type .COM, 
To see a directory of the disk in your 
primary drive, type DIR at the prompt. 

40 or 80 columns? 

When CP/M boots on the C-128, the 
system expects an 80 column screen as 
the output device. Consequently, infor- 
mation is formatted for 80 columns. If 
you are using a 40 column screen, the 
C-128 allows you to scroll across 80 col- 
umns using the grey cursor keys. If you 
haven't tried this yet, do so. You'll 
understand why I say that, though it 
works, it is very annojing. 

Unfortunately, most programs for 
CP/M expect an 80 column screen and 
format screen information accordingly, so 
you will have to use the screen scroll func- 
tion keys. However, if you are using on- 
ly the CP/M commands and utilities, you 
can tell the system to format output for 
a 40 column screen. 

To do this, insert the utilities disk con- 
taining the device.com file in the primary 
drive, and at the prompt type device con- 
sole [page columns = 40] < RETURN > , 
Until you change it again all subsequent 
CP/M output will be formatted for a 40- 
column screen. 

Copying disl^s 

The first thing I do when I get new disks 
is make backups. (The reason for this is 
another story that I'm only just starting 
to be able to laugh about). There is a 
reason other than security to make copies 
of the systems disks provided with the 
C-128. To ensure compatibility with 1541 
disk drives, the two sides of the 
distributed disks are recorded separate- 
ly on a single-sided disk drive. To access 
the second side you must flip the disk 
over! If you are using a 1571 you will 
want to copy these two sides onto a 
double-sided disk so that disk flipping is 
not necessary. 

Unlike other implementations of CP/M, 
a copy of the systems disk can be made 
using the PIP utility. Copysys is not im- 
plemented on the C-128. Files with the 
.SYS extension are treated in the same 
Contiimed overleaf. . . 
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A hard copy of Help 



by M. Garamszeghy 

Co]ryrigkt I9SS Miklos Gumwi^zeijhij 

CP/M Plus on the C-128 has a com- 
prehensive on-line Heij) facility that 
allows you to call up data on the vai'ious 
features of CP/M, and the syntax of 
mdsl of its commands. Sounds con- 
venient, doesn't it? 

Well , it is — except when you need 
it most: when you're stuck in the 
middle of a CP/M command or utility 
and you forget the command syntax. 
One solution is to exit the program or 
abort the command (assuming that you 
haven't forgotten how) and call up the 
Help routine. A better solution which 
I have found is to consult a hard copy 
of the Help file listing. The major por- 
tion of the Help.HLP file is an ASCII 
file (rememter that CP/M works in true 
ASCII, not PETSCII) containing the 
text for the <)n-.?ereen displays. 

When printed out on paper, the 83K 
byte Help file is over 40 pages of single- 
spaced text. That is a formidable 
amount of documentation for an on-line 
Help file. The file contains some very 
useful data, not found in the C-128 
users' guide, about the various CP/M 
commands and utility programs. This 
makes it a very handy reference tool 
for novice and experienced CP/M pro- 
grammers alike. 

There are several ways to create a 
hard copy of the Help.HLP file. 
Perhaps the easiest, though least 
elegant, method is to use the CP/M PIP 
command. WTien the CP/M prompt 
(A>) is displayed on the screen, tj'pe 
in pip lst: = hefp.hlp < RETURN >. 

Stime garbage will be printed on the 
printer. After several pages have been 
printed, the main text liody of the file 
will start to print. If you don't mind a 
few pages of garbage first, then this 
will produce an acceptable printout of 
the Help.HLP file. The garbage con- 
sists of an electronic table of contents 
for the main body of the Help file, 

If you are using a non-Commodore- 
compatible printer through an inter- 
face such as the CARDCO/?, the inter- 
face should be set for transparent mode 
for a standard ASCII print out. In ad- 



dition, the printer can be set to skip 
over the perforations on fanfold paper, 
if this feature is implemented on your 
printer, which produces a nicely for- 
matted oulput. A C'cnnmodore or com- 
patible printer should be set for upper 
case/lower case mode. However, 
because the Help file is in standard 
ASCII, upper-case characters will 
appear as lower-case, and vice versa. 
This is a minor inconvenience only. 

If you have a 1571 disk drive, the 
hard copy can be obtained in a slightly 
more elegant fashion, /^though it is not 
documented in the C-128 System Guide 
or even in the on-line Help file, the 
CP/M Plus Help command has two 
very important options: Extract and 
Create. These options allow you to con- 
vert the Help.HLP file into a standard 
ASCII text file , and then back into the 
Help.HLP file, respectively. To use 
these options, you must have a disk 
with at least 172K bytes of space on it 
(83K for Help.HLP, 7K for 
Help.COM, and 82K for the Help.DAT 
file created by the process). Unfor- 
tunately, this exceeds the 16SK of 
usable space on a single-sided C-128 
CP/M disk. 

The procedure is as follows. Format 
a disk as a double-sided CP/M disk on 
a 1571 drive. Next, copy the 
Heip.COM and Help.HLP files from 
the system disk to the new disk with 
the command pip e: = a:help.* 

< RETURN > (for a single drive copy); 
or pip b: = a:help.'* < RETURN > (for 
a dual drive copy). 

After the files have been;copied, put 
the new double-sided disk in the default 
drive, and type help ' [extract] 

< RETURN >. Extract can be abbre- 
viated to E. The drive will go on for 
several minutes and the message 'Ex- 
tracting data' will be displayed. The 
process creates a Se named Help.DAT. 
This is a standard ASCII text file con- 
taining only the text part of the 
Help.HLP file. The file can then be 
printed with the command: pip 
ist:=help,dat < RETURN >. Of 
greater interest, though, is the fact 
that the file can also be edited with any 
ASCII text editor, such as WordStar 
(in non-document mode) or the CP/M 



utility Ed.COM, You can re\dse the ex- 
isting material and even add some new 
stuff of your own! 

If you do add new data, each entry 
must l>e f)receded liy a header line in 
the following format: ///nheading 
name, where n is the Help level from 
1 to 9, and the heading name is the en- 
try name for the Help index. The three 
slashes must begin in the leftmost col- 
umn. A Help level of one indicates a 
major topic, while 2 to 9 are used for 
subtopics. The new material should be 
arranged in alphabetical nrder by 
primary heading and subtopics. It i-an 
Ix! inserted between existing topics if 
the alphabetical ordering so dicLaiL's. 
An example of a set of new entries 
would be: 

///INew Topic 

Put text here. 

///2Any Subtopic 

More text. 

///3Subsubtopic 

More text. 

///2BSubtopic 

Text for second subtopic. 

///ISecond new topic 

More text, 

. , .and so on. 

The text content can be anything that 
can be printed on the screen. To get a 
feel for the structure of the topic en- 
tries, it is best to examine a few of 
them with a text editor. 

Once the file has been edited and any 
new records added, it is reassembled 
into the Help.HLP file with the com- 
mand: help Cceate] < RETURN >. 
Create can be abbreviated to C. 

By using the E.xtract and Create op- 
tions for the Help command you can 
customize and update yom- Help file, 
and even add entries pertaining to your 
favourite programs. In addition, there 
is no law that says your Help file must 
contain data on CP/M commands. You 
can easily create a custom Help.HLP 
file containing names and addresses, or 
even recipes, which can he readily 
searched by a command such as: help 
John doe or help fudge brownies. This 
is in effect a free database program 
built into CP/M on the C-128! D 
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way as other files. Before making any 
copies, you must first format the destina- 
tion disks. To do this, insert your utilities 
disk with the format. com file on it into 
the primary drive, and at the prompt type 
format < RETURN > . This will load and 
initiate the format command. Follow the 
prompts to format as many disks as you 
like. 

When you've returned to the systems 
prompt, reinsert your systems disk with 
the pip.com file on it and at the prompt 
type: pip < RETURN >. This will load 
pip, the built in file manipulator, into 
memory, initiate execution and return 
with the pip prompt ('). You now have 
to tell pip from which disk to copy, the 
files to be copied, and the disk to copy 
them to. 

If you are using a single drive system, 
you will have to copy files from the 
primary drive (which I will assume to be 
A) to the virtual drive E. At the prompt 
type e: = a: * , • < RETURN > . CP/JVl will 
prompt you when it is time to shuffle 
disks. 

If you have more than one drive then 
you will be copying from the primary 
drive to another drive ( which I will 
assume to be drive B). At the prompt type 
b: = a:*.* <RETURN>. 

Since we want to copy the whole disk 
we've used the wildcard *.', which will 
match every file and cause it to be copied. 
The first asterisk matches the filename, 
while the second asterisk matches the file 
tjT)e. As in Commodore DOS, the ? can 
be used to match a single letter. After the 
disk is copied you will be returned to the 
* prompt. Copy the rest of your disks in 
the same manner. If you're using a 1571, 
remember that two single-sided disks can 
fit onto one double-sided disk. 

If you're curious about what you've 
been doing, one adequate source of infor- 
mation is the systems guide provided with 
the C-128 computer. A better source is 
also provided with the C-128 in a less ob- 
vious form. Built into the CP/M Pius 
operating system is a help command and 
extensive Help files. This information can 
be accessed by inserting the sytems disk 
with the help.com and help.hip files on 
it into your primary drive and typing help 
at the prompt. Follow the prompts to 
retrieve the information you desire. 

While more comprehensive than the 
C-128 manual, using online Help files can 
be inconvenient. If you are in the middle 
of executing a program and discover that 
you need some relevant information, you 
must abort the program, shuffle your 
disks and then call up the necessary Help 



file. Wouldn't it be nice if you could have 
all of this information available whenever 
you needed it, online or off? Guess what? 
Built into CP/M are provisions for prin- 
ting the Help files into a forty page Help 
manual! For complete instructions, see 
Mike Garamszeghy's sidebar accompany- 
ing this article. 

Where to get software 

A large number of commercial CP/M pro- 
grams are available to fill practically 
every need. Many of these packages are 
'vanilla' programs, designed to run on a 
variety of CP/M computers. If you are 
buying prepackaged CP/M programs, 
there are a couple of rules to remember: 

• Make sure the program disk contains 
an install file to configure the program 
to suit your system. 

• MP/M (multiple terminal CP/M) and 
CP/M-86 (CP/M for 16-bit computers) will 
not run under CP/M Plus. 

Alternative sources for CP/M programs 
are the various users' groups and public 
domain libraries, CP/M hackers have 
refined many of these programs to com- 
mercial quality over CP/M's ten-year 
history. They can usually be obtained for 
nominal membership or downloading 
fees. The rules for using commercial pro- 
grams apply here as well. 

The original version of CP/M shipped 
with the C-128 did not include support for 
the RS232 port. Consequently, it was im- 
possible to use a modem from within 
CP/M mode. Downloading CP/M files 
meant translating files downloaded in 128 
or 64 mode. Commodore has since re- 
leased an upgrade to the BIOS that of- 
fers a number of useful enhancements, in- 
cluding full support of the RS232 port. 

As well as a 128-mode library, TPUG's 
C-128 chapter has formed a CP/M mode 
library. Programs are distributed on 
single-sided disks recorded using CBM's 
OCR technique. With the permission of 
Commodore Canada, the files necessary 
to upgrade the BIOS are being 
distributed on the CP/M library's first 
disk, (Z)AA. 

As with other Chapter libraries, the 
C-128 library will only be as good as you 
make it. Please donate any public domain 
programs you may have found or written. 

D 

Adam Herst, in addition to being the co- 
coordinator for the C-128 chapter, is the 
TPUG CP/M librarian. He will continue 
to explore all aspects of CP/M on the C-128 
both at the chapter meetings and in future 
articles. 



Marketplace 



COMPUTER RENTALS 

We buy, trade, sell and repair 
Commodore computers. 
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1541 afignment 


S 29.00 


Box of 10 disks 


S 14.95 


4040 or 8050 Drive 


$995.00 


2031 Drive 


S375.00 


Superpet 


S995.00 


Green Monitor 


S 95.00 


Education software 


$ 3.00 



COMPUTER RENTALS 

17 Cedarbank Crescent 

Don Mills, Ontario M3B 3A3 

Tel: (416) 446-1035 



T1 General 

(Ontario) 

Income Tax 

Templates 

for the C-64 



includes schedules 1 to 10 

Available for $19,95 plus 

0,S.T. from 

R Link, Box 87, Beaverton, 

Ontario L0K1A0 

Specify one of 

Calc Result'", Multiplan^", 

or Better Working'", 



Commodore Repairs 

c-64 Computer $6B^^ 
1541 Disk Drive $699^ 

Total price includes pick-up 
and delivery. Dealer dis- 
counts available. 

VOYAGEUR 

Bo.\ 730 Almonte. Ontario 
KOA lAO 

Tel. 613-256-2597 



Autobooting on the C-128 



by M. Garamszeghy 

Copyright ® 1986 M. Garamszeghy 

The C-128 has the ability to automatic- 
ally load and run either a machine 
language or BASIC program from disk 
at power-up or when the reset button is 
pressed. In this process, known as 'auto- 
booting', the computer loads the contents 
of track 1, sector from the disk into 
memory at address 2186 in bank (part 
of the BASIC stack area) and checks to 
see if that sector begins with a certain 
sequence of bytes. If the byte pattern is 
found, the machine language instructions 
in the remainder of the sector are ex- 
ecuted. This feature works with both the 
1571 and 1541 disk drives, as well as with 
most other compatible Commodore and 
non-Commodore drives. 

The required byte sequence consists of 
the three character string "CBM", 
followed by four zero bytes. This can be 
followed by an optional message (up to 
sixteen characters) to be displayed dur- 
ing boot-up. The message is followed by 
two more zero bytes. This sequence is 
followed by some machine language in- 
structions and a BASIC command string 
consisting of either RUN<fllename> or 
BOOT<fiIename> for BASIC or 
machine language programs, respective- 
ly. The final byte is another zero. The 
machine language instructions are: 

Idx ^address low 
Idy ^address high 
jitip $[iea5 

' Address low' and 'address high' are the 
low and high bytes of the beginning of the 
RUN or BOOT string that follows. This 
address may change depending on the 
length of the boot message string. The 
JMP instruction transfers execution to a 
routine in the BASIC ROM. 

The program below, Autoboot Maker, 
allows you to write the required byte pat- 
tern to make a boot disk. One word of 
caution , however. Since the program uses 
the random block-write method to write 
the boot sector, the boot disk should not 
be subjected to the DOS Validate or 
BASIC 7.0 COLLECT commands. Either 
of these commands may cause the boot 
sector to be overwritten, and will in any 
case cause it to become deallocated. 
Autoboot Maker will warn you if it finds 
track 1 , sector already allocated. In that 



case, you can either overwrite the ex- 
isting sector or try another disk. If the 
disk already has a boot sector written, the 
old data will be replaced by the new. In 
any event, it is perhaps better to write 
a boot sector on a new disk immediately 
after formatting it. This ensures that the 
sector does not have any valid data on it. 
Interestingly, the BASIC command 
string used in the boot sector is not 
hmited to BOOT<fllename> or RUN- 
<fllename>, but can be any valid im- 
mediate mode BASIC command. By 
changing lines 70 and 80 of the program 
to: 

70 bo$-bo$+"directory"+ 
chr$( 0) 

for instance, you could have an automatic 
display of the disk directory on boot-up. 
Other useful applications include 
DLOADing a program (without running 
it); BLOADing a machine language utili- 
ty, sprite data, function key definitions 
or a custom title screen; or perhaps mere- 
ly changing the screen colours with a cou- 
ple of COLOR commands. The only ap- 
parent restriction on the command string 
is that its total length must be less than 
one BASIC line (up to 160 chai-acters) and 
must contain only one logical line (that is, 
no CHRS(13)s). All statements must be 
immediate mode (INPUT and GET are not 
allowed). 

Of course , most of the above applications 
(except for the DLOAD) can be performed 
by a RUN<fllename> type command 
string. However, while these programs 
are easily accessible to prying eyes from 
the disk directory , a person needs a disk 
sector editor to view or change the con- 
tents of a custom boot sector command 
string. 

IB bo$="cbin'*:c0$=chr$[e] :fo 
ri=1to4:bo$=bo$+c0$ :next 
:colora,7: color4,7:prln 
t" " 

28 prinfboot message* :lnpu 
t" max 16 chars" ;me|:me$ 
= left$[ffle$J6] :sa=2B3U 
lenCnieS] 

30 input" boot file name'';b 
f$:input" [b]asic or [m] 
ach. lang.";ft$:print" " 

40 dclosetprinf boot mess 
age: "meS: print* boat fi 



le name: "bf$; : ifft$="m 
"thenprint* mach. lang. 
" :elseprint'' basic": 
50 input" ok [y/n] ";o$:ifo 

$<>"y"thBn1B 
60 bo$=bo$+me$+c0$4c8$+chr$ 
C 162) +chrJC 25Sandsa) +chr 
$( 160) -HchrSf sa/2S6) +chr$ 
[ 76) +chr$C 1 65) +chr$( 175} 
70 ifft$="m"thenbo$=bo$-fr"bo 

ot" :elsebo$=bot+"run" 
80 bo$=bo$-^ch^$(34)-^bf$-^ch^ 
$(0) :open15,8, 1S:open8,8 
,8, "l":ifd3thendclo8e:ga 
tolls 
90 print#1S,"u1:";8;0; l;0:p 
rint#15,"b-a:"-,0; l;0:if 
ds^6Sthen120 
100 print#15,"b-p:";8;0:pri 
nt#a,bo$;:print#15,"u2: 
";8;0; 1;0:dclose: ifds 
theni 10:elseend 
110 print" disk error >> "; 

ds$:goto4a 
120 print" boot sector air 
eady in use*:input" ov 
er-write [y/nl";ow$: if 
ow$="y"then1B0:else4O 



FREE SHOPPING BY MODEM 

SATELLITE ELECTRONIC 
SHOPPING MALL 

Take advantage of this lirst FREE electronic shop- 
ping mall- Available id all computer and modem 
users - 

Now you can sriop lor insurance, cars, compulers. 
books, software, travel Ickels S tiolidays. and 
much more in the comlon ol your own hotJie or of- 
lice. The electrcnic stores are open 24 hours a day. 
7 days a week lor your convsnience- 

Slores In the Mall Modem 

Bayside Computerized 8310666 

Insurance Shopping Data Base 
Compu-Car 831-6678 

Shop tor new GM. Chrysler, and Ford cars 
Computer Shoppe 831-6907 

Order computer hardware 
Alpha Books 4 Software 831-6908 

Order computer books and software 

Electronic Travel Agency Coming soon 

Book (lights, holidays & hotels 

And More Openings Coming 

Check with any ol the shops lor more mall inlormation . 

LINK UP WITH YOUR 
SATELLITE DEALER TODAY!! 
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A scrounger's guide to CP/M 



How to beg, borrow and otherwise 
obtain CP/M software for the 0-128 



by M. Garamszeghy 

Copyright ® 1986 M. Garamszeghy 

CP/M opens a whole new world of adven- 
ture for both the casual and serious Com- 
modore computer user. Although it is one 
of the oldest microcomputer operating 
systems (born circa 1975), and has been 
implemented to a limited degree on other 
Commodore machines, it is totally new to 
most owners of the C-128. Over the 
years, CP/M has become almost the de 
facto standard for 8-bit computer 
operating systems, especially business- 
oriented systems. 

There are literally thousands of CP/M 
computer programs on the market and in 
public domain libraries. Many of these 
programs will, in theory, run on the 
C-128. The problem lies in the fact that 
practically none of the software is 
available in Commodore GCR disk for- 
mat, the recording technique used ex- 
clusively by the 1541. 

You may not realize it, but there was 
some CP/M software included with the 
C-128 computer. If your machine came 
with only one CP/M disk (marked 'System 
Disk') like mine did, turn it over! Even 
if you have one of the new double-sided 
1571 drives, you must still turn the disk 
over to access the second side. The flip 
side (marked 'User Utilities Disk') con- 
tains most of the utilities referred to in 
the manual - Ed.COM, Date.COM, Sub- 
mit.COM and other CP/M favourites. 
(Because I generally do not use 'flippies', 
it took me three months before I noticed 
this, quite by accident.) 

Another valuable source of CP/M soft- 
ware and technical information is the 
mail-away card packed in the C-1Z8 
System Guide manual. If you are serious 
about CP/M programming, the two-inch 
thick manual and the three disks (one flip- 
py and one single-sided) that you get for 
your 20 bucks (30 Canadian) are well 
worth the money. The manual contains 
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very detailed instructions on the CP/M 
resident commands, as well as the tran- 
sient utilities. For the machine language 
programmers and hardware hackers, it 
also contains detailed information on the 
various BIOS and BDOS function calls, 
complete with examples of how to use 
them. The disks contain a whole slew of 
machine language -oriented utilities, such 
as the two main CP/M assemblers 
Mac.COM and RMac.COM, and the 
dissassembler Sid.COM. Also included 
are demonstration assembly language 
programs and library files. 

. . . Commercial CP/M 
software is available in 
many different disk for- 
mats. Unfortunately, 
Commodore GCR is 
usually not one of 
them . . 

The next major source of CP/M soft- 
ware is the public domain libraries. 
(Although their stocks are usually limited, 
there are a few public domain libraries 
that cater to Commodore CP/M users at 
modest cost. One that comes to mind is 
Poseidon Electronics, 103 Waverly Place, 
New York, New York, 10011.) Most of 
these libraries operate bulletin boards 
(remote CP/M — RCP/Ms, in the popular 
lingo), where the software can be upload- 
ed or downloaded for a nominal charge. 
This, of course, assumes that you have a 
modem and a suitable terminal program 
for your 128 (usually a form of X-Modem, 
otherwise known as M0DEM7, which is 
the standard CP/M program file transfer 
protocol). 

Commercial CP/M software is available 
in many different disk formats. Unfor- 
tunately, Commodore GCR is usually not 
one of them. The problem of disk format 



incompatibility was reduced with the in- 
troduction of the 1571 disk drive, which 
can read most of the popular CP/M disk 
formats (except Apple CP/M, which is 
perhaps the most common). However, 
that is no help to people like myself, who 
do not have a 1571 drive. Despite this, I 
now have a fairly extensive library of 
CP/M software (including such favourites 
as WordStar, CalcStar, dBase II, 
MBASIC and Fortran-80) on 1541 for- 
mat disks, thanks to a bit of electronic 
jiggery-pokery. The trick lies in first ob- 
taining the software in a format readable 
by a 1571 drive, then using the genius of 
the 1571 to translate for you. The catch 
is, of course, that you must have tem- 
porary access to a 1571. 1 used one in a 
local computer store, the manager of 
which didn't seem to mind me playing 
with his demo equipment for a couple of 
hours. 

The 1571 is truly a remarkable 
machine. Using the CP/M PIP.COM utili- 
ty ('PIP' stands for Peripheral Inter- 
change Progfram — I never could figure 
out why they just didn't call it Copy), you 
can copy from a foreign disk format to 
1541 GCR format with a single drive. The 
procedure is as follows. First format 
some blank disks as C-128 single -sided 
disks with the CP/M Format command. 
These are equivalent to 1541 format 
CP/M disks. Next, with the CP/M system 
disk (the boot disk that comes with the 
computer) in the drive, type PIP 
< RETURN >. When PIP is loaded and 
ready to run, it will respond with the 
prompt *. 

Now you can copy the program files. 
Remove the system disk and replace it 
with the foreign disk containing the files 
you wish to copy. To copy an entire disk, 
enter the command 

e: = a: * . * < RETURN > . To copy a single 
file, use e: = a:<filename.ext>< 
RETURN >, where filename.ext is the 
filename and extension of the file you 



wish to copy. The 1571 will buzz and click 
for a few moments. A reverse video 
message will appear at the bottom of the 
screen listing the suspected format of the 
foreign disk. The message 'IBM-SS', for 
example, indicates a single-sided IBM 
CP/M-86 format disk. If you know this to 
be the correct format, press RETURN. Do 
not use the CTRL-RETURN key combina- 
tion to lock in the disk format. 

The 1571 will log drive a: as that for- 
mat. If you know for sure that the pro- 
posed format is incorrect, or if you wish 
to see what other choices you have for 
that disk format (some disk formats are 
similar enough that the 1571 cannot 
automatically distinguish between them), 
use the cursor-left and cursor-right keys 
to scroll through the choices. When you 
find the correct one, press RETURN. 
Single-drive copying is then performed by 
following the prompts on the screen for 
removing and inserting the disks at the 
correct times. Press RETURN to restart 
the copying each time you insert a disk. 
Disk a: is the foreign source disk, and disk 
e: is the C-128 destination disk. It may 
be a good idea to cover the write-protect 
notch on the source disk to prevent 
disaster from striking if you accidental- 
ly mix up the two disks. Drive e: is a 
'phantom', or virtual, disk drive. It does 
not really exist except in the memory of 
the C-128. This concept is essential for 
single-drive copying. 

If you are using two drives, a: and b; 
(either two 1571s — one set to device 
number 8, and the other set to device 9 
via the DIP switches at the back — or a 
1571 set to device 8 and a 1541 set to 
device 9 via the hardware method), you 
can use the command 

b: = a:*.*<RETURN> or 

b: = a: < filename.ext > < RETURN > , 
where the source disk is in drive a: and 
the destination disk is in drive b:. With 
two drives it is not necessary to swap 
disks during the copying process. A 
similar procedure to that described above 
can also be used for copying files from 
C-128 format to a foreign format, and 
between two foreign formats. 

Once the programs have been transfer- 
red to 1541 format, the easiest way to 
back up your software with a 1541 is to 
start up the C-128 in C-64 mode, and use 
one of the many '3 minute' disk copying 
programs available. This, of course, can 
only be used to copy whole disks. You will 
still need the CP/M PIP command to copy 
individual files. 

If you own a 1571 drive, you can pur- 
chase CP/M software in a wide variety of 
popular disk formats. Of course, these 



will be 5 1/4-inch disks. Much CP/M soft- 
ware, including all of the stuff I started 
with, is available on 8-inch disks. (This 
was how aJl CP/M software was originally 
used.) How, do you ask, did I get these 
8-inch disks into the 1571 drive to copy 
them? The answer is, obviously, I didn't. 
What I did use was a bit of creative 
hacking. 

My software started life on 8-inch 
CP/M disks used on an ancient (circa 
1981!) TRS-80 Model II computer. The 
programs were transferred via a null 
modem cable to a nearby IBM-PC. (For 
the benefit of techies, I used an X-Modem 
program on the TRS, and CrossTalk in 
X-Modem mode on the PC.) The result 
was a set of CP/M files on 5 1/4-inch 
disks, but in PC-DOS format. Despite all 
its talents, the 1571 cannot decode the 
directory data on PC-DOS disks. (CP/M 
directories are of the same structure in 
any disk format and are very simple to 
decipher). To overcome this, I wrote a 
short hybrid machine language-BASIC 
program for the IBM-PC which converts 
PC-DOS files into the CP/M-86 files that 
can be read by the 1571, thus readying 
them for translation into 1541 format. 
The point to this paragraph is not to show 
a roundabout method to get CP/M soft- 
ware for the C-128, but to emphasize that 
CP/M software from one machine and 
disk format can be easily made (relative- 
ly speaking) to run with a totally different 
machine and disk format. 

With some CP/M software, it is 
necessary to 'configure' the program for 
the specific hardware features of your 
system. Popular CP/M software, such as 
WordStar, often comes with an installa- 
tion program allowing you to set up the 
software for running on a wide variety 
of computer systems. Unfortunately, I 
very much doubt that you will find a con- 
figuration program that has the C-128 in 
its list of supported systems. This may 
change as the C-128 gains popularity. 
However, the engineers at Commodore 
had the good sense to make the C-128 
emulate one of the more popular com- 
puter terminals, the Lear Siegler 
ADM-31. (It also emulates the less 
sophisticated ADM-3A.)The LS-ADM-31 
is found on nearly all CP/M configuration 
program menus. Thus, almost all CP/M 
software can be configured to run on the 
C-128. 

Incidentally, this article was written 
with WordStar configured for the 
ADM-31, using a 1541 disk drive. Not the 
fastest word processor combination 
around (for obvious reasons), but still 
quite manageable. D 



Missing Letter Puzzle 

1) Insert your COMAL disk in drive*. 

2) Type LOAD "064 COMAL*",8 

3) Type RUN (utartii COMAL) 

4) Type AUTO (turn on auto line#'8) 

5) Enter the program lines shown below 

(COMAL indents lines for you) 

6) Hit RETURN key twice when done 

7) Type RUN 

Pr-gr-mm-r'a P-r-d-B- P-ck-g- 
Programmer's Par? 

0010 dim text$ of 39, diski of 2 

0020 open file 2,"miB8ing.dat'',reftd 

0030 disk*:=»tatu8j; count:=0 

0040 if diokt="00" then 

0050 count "text 

0060 else 

0070 close //no data file found 

0080 create'text 

0090 endif 

0100 play'game 

0110 // 

0120 proc count'text 

0130 while not eof(2) do 

0140 read file 2: text} 

0150 count:-|-l 

0160 endwhile 

0170 close 

0180 endproc count'text 

0190 // 

0200 proc create'text 

0210 open file 2,"mi8sing,dat", write 

0220 print "input text (or blank);" 

0230 repeat 

0240 input text$ 

0260 if text$>'"' then 

0260 write file 2: textj 

0270 count:-l-l 

0280 endif 

0290 until textj="" 

0300 close 

0310 endproc create'text 

0320 // 

0330 proc play'game 

0340 open file 2,"niissing.dat",read 

0350 for x:=l to rnd(l,count) do 

0360 read file 2: text} 

0370 end for X 

0380 close 

0390 for letter:=l to len(textj) do 

0400 if text$(letter) in "aeiou" then 

0410 print "-", 

0420 else 

0430 print text $ (letter), 

0440 endif 

0450 endfor letter 

0460 print 

0470 for letter:=:l to len(text*) do 

0480 while key$<>text$(letter) do 

0490 print ''?"-f-chrJ(157), //left 

0500 endwhile 

0510 print text$(letter), 

0520 endfor letter 

0530 endproc play'game 

• If you don't have COMAL yet, order a 
Programmer's Paradise Package -$19.95. 
It includes the complete COMAL system 
plus over 400 pages of information. Add 
$5 more to get our 20 interactive lesson 
Tutorial Disk. Add $2 shipping. Visa/MC 
or US funds check accepted. Send to: 

COMAL Users Group USA 

6041 Monona Drive, Room 109 
Madison, WI 53716 
phone 608-222-4432 
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C-128 book flawed but useful 



Commodore 128 
Internals 

by K. Gerits, 

J. Schieb and F. Thrun 

from Abacus Software 



Review by Jim Butterfield 

Copyright ® 1986 Jim Butte) field. Permis- 
sion to reprint is hereby granted, provid- 
ed this notice is incliuied in the repritited 
material. 

This booi; contains a great deal of infor- 
mation about the Commodore 128 that is 
not yet generally available. It contains a 
rich fund of technical data on the 128, 
together with comments on the C-64 
mode as it fits together with the machine. 
The information isn't complete (perhaps 
it's too early to hope for that yet). There 
are some inaccuracies. And the material 
is heavily technical . . . it's not suitable for 
a beginning level programmer or user. 
Considerable machine language ex- 
perience is called for in working through 
the book. 

Hacker's heaven 

The book has a heavy hard- 
ware/hacker/machine language content. 
You know that if a chip is mentioned, 
you'll get detailed pinout diagrams and 
register descriptions. If an interface is 
described, you will get a picture of the 
edge connector and possibly information 
on voltage levels. Good for ser\'ice depart- 
ments, but probably overkill for the pro- 
grammer and user who would never think 
of diving in with a soldering iron. This 
kind of detail is featured prominently, 
and takes up a fair amount of space in the 
book; the reader who doesn't need it will 
end up browsing through to areas of more 
interest. 

The book also spends a good deal of 
time and space on 'known' hardware and 
techniques. Even though the 40-column 
chip has only two new registers (at 
$D02F and $D030), the whole chip is 



discussed at length in Chapter 2. You'll 
get the story on sprites, split screens, 
character sets, screen colours, high- 
resolution, multicolour and extended col- 
our modes. None of this is new, and in 
this area the book cautions, "all of the 
following programs must be entered in 
the 64 mode". The two new registers are 
not discussed at this point. You'll find 
similar detailed discussions of 'known' 
chips in Chapters 3 and 4, which deal with 
the CIAs and with the SID chip. 

If you're moving up from the Com- 
modore 64, you might feel that you know 
all this stuff, and that you'd rather see 
the book focus specifically on new 
materia!. On the other hand, you might 
be pleased to see the book attempting to 
cover the entire range of the architecture. 
Chapters 5 and 6 do break considerable 
new ground. The VDC — the Visual 
Display Chip that drives the 80K:olumn 
display — is outlined in detail and several 
of its idiosyncrasies are discussed. And 
the MMU — the Memory Management 
Unit that controls the architecture of the 
computer — is also outlined. Until the 
Commodore Programmer's Reference 
Guide becomes available, this book may 
be one of the best sources of information 
on these two chips. 

Chapter 7 is titled 'Assembly Language 
Programming'. It largely discusses the 
Kernal routines, and how to create a 
'boot' or autostart disk. It is the last 'nar- 
rative' chapter of the book . . . and yet the 
book is less than half finished. 

Chapter 8 is the bulkiest part of the 
book. It contains a detailed disassembly 
of Kernal ROM, with each line com- 
mented. I miss the BASIC ROMs, but 
they are 32K in size, and including them 
would have more than doubled the size of 
this book, which is already massive. To 
read such ROM listings, a user needs to 
have some expertise. The pieces of code 
fit together jigsaw fashion, and to under- 
stand one part the reader will need to 
know how other parts interrelate. The 
disassembly code contains some 'Euro- 
pean' ROM progamming that is not found 
in North American models of the Com- 
modore 128. 

The verdict 

The book is relatively good, but is not 
completely free of errors. Part of the 
disassembly on page 387 is wrongly per- 



formed (instructions at F934, F936 and 
F94B are not shown correctly). The 
memory configuration table on page 145 
has copied a typographical error from 
some early Commodore documentation; 
configuration 13 should reference RAM 
0, not RAM 1 as shown. 

This book is not an easy read. There's 
a lot of good information here, but you'll 
have to dig for it. There's an index, but 
it's of limited use. The writing style is 
often stuffy ("Those who think it would 
be boring to take a close look at this chip 
would be decei\Hng themselves.") 

But there's good stuff in here. The book 
is out early, and contains a great deal of 
data not easily available from other 
sources. For the serious student — and 
you'd better be a serious student — it's 
a goldmine of good information. 

Commodore 128 Internals, Abamts Sofi- 
ware, PO Box 7211, Grand Rapids, 
Michigan 49510. D 



MOW GET TRUE DESCENDERS 
FOR 801. 1525, 803. GP-100, 
HUSH 80 & SIMILAR PRINTERS 

From f/>0 D»se»nd9r ROM Peoptt 

peopi 

SAMPLE 
ACTUAL SIZE 

FEATURING : 



ARTS 



• True descenders 

• A pleasing alternative 

• Uniform ctfaracter formation 

• No change In graphic capability 

• No change in software compatibility 

• No change in printer operation 

• North American standard font 

• Complete Instructions 

• Eaay instaliatlon 

• No soldering 

$39.95 Cdn $29.95 U.S. 

Ont. Rtiidintt udd 7V, Proy Solei Tai 
Chequ*. MontK Ordjr , V rto or MoUBfCord 
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WILANTA ARTS 

6943 Barrlsdale Dr. 

Mississauga Ont. 

L5N 2HS 

1-416-858-9298 

Gat a Wilanta Descender ROM Today 

and make your old nightmara 
Just a font memory of yesterday ! 
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ATTENTION 

ALL COMMODORE 64, 

VIC 20, COMMODORE 16, 

AND PET OWNERS 

A complele self-tutoring BASIC programming course 
is now avaiiable. Ttiis course starts witli turning 
your computer on, to programming just about 
anyttiing you want! Ttiis course is currently used 
in both Higti Scliool and Adult Evening Education 
classes and has also formed the basis of teacher 
literacy programs. Written by a teacher, who after 
having taught the course several times, has put 
together one of the finest programming courses 
available today. This complete 13 lesson course 
of over 220 pages is now available for the C0f\/1- 
f\/ODORE 64, VIC 20. COtVlMODORE 16 and PET 
computers and takes you step by step through a 
discovery approach to programming and you can 
do it all in your leisure lime! The lessons are filled 
with examples and easy to^ understand explanations 
as well as many programs for you to make up. At the 
end of each lesson is a test of the information 
presented. Furthermore, ALL answers are supplied 
to all the questions and programs, including the 
answers to the tests. Follow this course step by 
step, lesson by lesson, and turn yourself into a 
real programmer! You won't be disappointed! 

We will send this COMPLETE course to you at 
once for just $19.95 plus $3.00 for shipping and 
handling (U.S. residents, please pay in U.S. funds). 
If you are not COMPLETELY satisfied, then simply 
return the course within 10 days of receipt for a 

FULL refund. 

Now available! a 200 page course 
exclusively on sequential and rel- 
ative files using a unique approach 
for those with very limited file programming ex- 
perience - set up your own personal and business 
records! — disk drive a must — same author — 
same guarantee — same cost — this course for 
all computers except Vic 20. 
Fill in the coupon or send a facsimile. 



FOLLOW UP 
COURSE 



1 NAMF: 


TP 


1 ADDRESS: 


j CITY 


1 PROV/STATF- 


1 POSTAI/7IP CODF 


1 I desire the BASIC program- 
1 ming course lor: 


Any complete course: $19,95 
Postaqe and tiandlinq: $3.00 


1 Commodore 64 D VIcD 
PetL Commodore 160 

1 1 desire the lollow up r. 

1 course on relative and 
sequential files (for all above 
computers but Vic 20). 


Tolal: $22,95 
Send Cheque or Money Order lo: 
Brantford Educational Services 
6 Pioneer Place, 
Brantford. Ontario, 
Canada N3R 7G7 



INTRODUCING 



THE HRT SUPER-RES 



GRAPHICS BOARD 




This IS a grapiiics board whicti is universally compatible with all models of 
PET'S- With Superpets (both 2 and 3 boards) It works equally well on both the 
6502 and 6809 side as well as with OS-9- The graphics board is the result of 
two years of R&D which began in Nov 83 with the (Irsi prololype. Then 
starling m [Vlar 84 it was test marketed for tour months through TPUG 
Magazine The original model only worked on the 2001 with a resolution of 
320 X 200 At the e-l TPU6 Conference the 4016 and 4032 models were 
unveiled Then in Dec, 84 at the Superpet chapter meeting the 8032. 8096 
and 9000 models were introduced Over the last year these different models 
were field tested in schools, universities, business and homes. The HRT 
SUPER-RES GRAPHICS BOARD was (hen designed with the results from 
these tests and input from expert users. 

The window size is 700 hor, by 300 ver tor thee032's. 8096's and 9000's and 
640 X 200 for all other models. However the card has an even larger resolution 
of 1024 X 512 pixels, Ttie most that can be displayed on the monitor is 
determined by the window size but the card supports scrolling left, nght. down 
and up to view the entire graphics area. This window can be defined lo any 
size, can be located anywhere on the monitor and can scroll about the 1 024 x 
512 pixels The graphics can even be overiayed on top of the text without 
interfering (even if both text and graphics are scrolling). 
To accomplish this high resolution the board has its own 64K of ram. Another 
attractive feature is that this extra memory can alternatively be used as a ram 
disk. 

The aiMve picture has a window size of 700 x 300 and can be scrolled about to 
reveal the entire 1024 x 512 pixels The picture of the gid is 280 x 192 and 
only one image can be shown on an Apple II Computer, (the original source) 
A large software package is included with the purchase of the super-res board. 
H includes plotting utilities, sketching routines, turtle graphics, algebaric 
graphs, animation routines etc. 

Ease of installation is one of the importanl design features. The circuit board 
simply plugs into the mother board under the monitor with no soldering 
required. 

Please send cheque or IW for 5200,00 U,S./S25:).00Cdn.plusS5shipping 
and handling (Ontario residents please add 7% Prov, Sales Tax) To HIGH RES 
TECHNOLOGIES 16 ENGLISHIVYWAY, TORONTO. ONTARIO M2H 3M4, 
Note: Please specify computer and disk drive model numbers. 
(416)497-6493 



Amiga Dispatches 



by Tim Grantham 

On a sea of wild rumours about CBM's 
imminent demise, the Amiga has sailed 
on, propelled by waves of new software, 
buoyed by continuing excitement over its 
extraordinary capabilities. No other com- 
puter has had so much software available 
so soon after its debut. Yet it's not an 
easy computer to market — there's just 
nothing else like it. Of the one million (!) 
computers Commodore sold in the last 
quarter of 1985, only 10,000 were 
Amigas. But chin up, Amigos! We believe 
that given time, the Amiga will boldly go 
where no computer has gone before. 
Meanwhile, more news from the 
frontiers. 

CP Update 

The controversy over copy protecting 
software for a machine designed from the 
bottom up fur multitasking rages on. 
Electronic Arts has continued to press for 
innovative approaches. For a time, they 
were considering a kind of optical dongle 
used in Engiand: a piece of coloured 
plastic that the user looks through when 
booting up the program. Cheap to manu- 
facture (but difficult to synthesize at 
home), they enable the user to read a 
series of encrypted characters on the 
boot-up screen. Once these are entered, 
the program continues. 

It's not only end-users who are fighting 
EA on the CP issue — witness the follow- 
ing from one software developer: 

#: 6188 Si/Software 

25-Jan-86 02:53:39 
Sb: #6132-electronic arts 
Fm: ben blish 72667,1341 
To: Electronic Arts 76004,237 
. . . The package my company is creating 
Is priced in the $1000.00 range... 
Eminently Stealable . , . and it is NOT copy 
protected. If it is stolen, among other things, 
I will lose my home, and probably my wife. 
However, human nature is generally good, 
and I will take the chance, and I will not take 
the chance of aggravating my bona fide 
customers. Anyway, I am not a thief, lots 
of others aren't either, and YOU can afford 
to take the chance. Please do so. And 
that's my Opinion. — Ben Blish, SoftCir- 
cuits Inc; 305-721-2707 anytime — 
EA responded thusly: 

#: 7244 Si/Software 

04-Feb-86 19:32:56 



Sb: #EA Copy Protection 
Fm: Electronic Arts 76004,237 
To: all 

Okay, I have a proposal: What is your opi- 
nion il we: a) continue to sell our utilities pro- 
tected, although the protection is of the 
type that lets you make backups. When 
booting, it requests that you insert the 
master disk, to verify the signature. 
However, b) enclosed in the package is a 
card that lets you, with proof of purchase, 
buy a completely unprotected version for 
say $10-$20. 1 think that most users will not 
be upset at just using the first version, but 
for those who really need it, the un- 
protected version will be available. To pur- 
chase the unprotected version, we will pro- 
bably have on the card some sort of site 
license/non-piracy agreement to sign, 
and/or we might encrypt (but not display) 
your name, address, etc. in the disk we 
send you. Again, this is just a proposal, so 
I want your feedback. Thanks. 

Jeff J. - EA 

Response to this has been generally 
favourable. EA is to be commended on 
their continuing dialogue in this matter. 
Drop a line to EA if you have any con- 
structive ideas on this very important 
subject. 

As a final note, one company already 
has a copy program in beta-test that has 
proved capable of backing-up Deluxe 
Paint, and all other EA software. 

Software Bulletins 

These just in . . . Micro-Systems Software 
continues to lead the way in productivi- 
ty software with its Online! terminal soft- 
ware, for which two (free) upgrades have 
already been issued. File transfers with 
CompuServe's B protocol are included in 
the latest version (vl.26). Analyze!, a 
spreadsheet, was released in January, 
and Scribble!, a word processor, is cur- 
rently in beta-test and should be available 
shortly ... By the time you read this, TDI 
software will have released its Modula-2 
compiler {not copy-protected). Borland, 
famous for its Turbo Pascal, should have 
the Amiga version ready by the middle 
of this year. . . Aegis* Pro Draw CAD 
software will share AutoCAD's program - 
mability. Prices on latest Aegis software 
are as follows: Animator/Images combo. 
$139,95, Images $79.95, Impact $199,95, 
Draw $199.95 (all prices US). . . 
Michael Reichmann of Batteries 



Included has announced that BI are 
developing a version of the Degas draw- 
ing software, considerably enhanced from 
the Atari ST version. The author is Tom 
Hudson, Availability — some time this 
summer. BI has also announced that no 
forthcoming Amiga programs from them 
will use any CP. . . Paul Higginbottom , 
Amiga Product Manager, and well-knowTi 
to TPUG members, has announced the 
imminent arrival of AmigaTERM, C-A's 
own terminal software. . . Ben Blish, of 
Soft Systems, has sent out copies of his 
POLO printed circuit board CAD pro- 
gram, which makes full use of Amiga's 
graphics, mouse, and multitasking en- 
vironment, for beta-test. He has promis- 
ed that there will be no copy-protection 
on it. . . 

Tom Casey, co-author of Deluxe Video 
Construction Set, appeared on the 
Amigaforum on CompuServe to explain 
the delay on release of the program. It 
is currently in beta-test, but he wants to 
get all the kinks out of this extremely 
powerful and innovative software. With 
fingers crossed, he hopes it will be ready 
in March. DVCS can import any image, 
sound or music in the IFF format jointly 
developed by EA and C-A. . . The new 
ROM Kernel 1 , 1 manuals are being ship- 
ped to developers and include the 
necessary info on the printer drivers, so 
all the people crying out for a way to get 
their printer into Preferences shall soon 
be quieted . . . Bob Perez has handed over 
the porting of his VMCO terminal pro- 
gram for the Mac to the legendary Cap- 
tain Crunch, aka John Draper. . . 

Ashton-Tate is soliciting requests for an 
Arnica version of dBaselll. If you would 
like to see this happen, leave Email to the 
Sysop of the Ashton-Tate forum on CIS, 
Steve Silverwood [76703,3035] . . . C-A is 
rumoured to be preparing a disk full of 
PD software, including Andrew Finkle's 
version of MicroEMACS. . . Finally, 
there are apparently different versions of 
the IBM emulator in beta-test, resulting 
in conflicting reports of its ability to run 
various MS-DOS programs. Some can get 
Borland's Sidekick program to run, 
while others get only crashes. One per- 
son claims to have been able to run CP/M 
software on the Amiga, using an MS-DOS 
CP/M emulator running under the IBM 
emulator! 

Hardware News 

Unlike those of us in the frozen north, 
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user groups in the US are getting 
demonstrations of new peripherals, Larrj' 
Miller of FAUG (First Amiga Users 
Group) gave a lengthy report on CIS of 
a demo of a frame grabber called LI VE , 
from A-Squared Systems. The unit plugs 
into the bus expander on the right side 
of the computer and, in combination with 
the software, digitizes a standard com- 
posite colour video signal into RAM in 
IFF format (so the Deluxe series can use 
it), for about 300 dollars. It should be 
available in the second quarter, providing 
the FCC doesn't hang it up. It does tie 
up the computer so that no other tasks 
can be performed while it is in operation , 
and it is also a 'bus end': it does not pass 
on the other signals on the bus. This 
means you would not be able to use it in 
combination with other 'bus end' units, 
such as the hardware IBM emulator is 
rumoured to be. A-Squared is working on 
a 'Professional' model (at much higher 
cost) for those who want to process Land- 
Sat photos, for infrared and X-ray image 
analysis, and so on. 

'ft'fiile we are on the subject of video, 
the Genlock interface is ready for release. 
William Volk, of Aegis Development told 
me that he had used a production (not a 
prototype) unit to overlay a rotating 3-D 
NBC logo created with Aegis Draw on 
a television picture from a VCR, on the 
Amiga's monitor. 

Two reps from Tecmar gave a short 
demo of their Hard Disk and Expansion 
Module at the Cleveland Amiga Users 
Group. Apparently, only FCC approval is 
required, though Tecmar says there is no 
way they can meet the current demand; 
they just can't build them fast enough. 
Microforge is also producing hard disks 
in various capacities, but Paul Higginbot- 
tom reports that both Microforge and 
Tecmar's products make the mistake of 
stopping other processes when they ac- 
cess the drive, Carl Sassenrath, author 
of the EXEC on the Amiga, has assured 
everyone that this is not the fault of the 
Amiga OS. 

A-Time is a clock-card that plugs into 
the parallel port. It has a parallel port on 
the back, and sells for 849,95. It's 
available from Akron Systems Develop- 
ment, P.O. Box 6408, Beaumont, TX 
77705. 

It looks like CBM's encounter with 
Andy Warhol has not proved too rich for 
their blood. They are continuing their 
promotion of the Amiga as a tool for ar- 
tists by announcing their sponsorship of 
the Amiga Studio Theatre in the Cana- 
dian Pavilion at Expo 86. CBM will pro- 
vide 20 Amiga computers for use by per- 
forming artists across Canada, to create 



new works or to integrate special effects 
into their performances. 

Some Users are exploring the Amiga's 
multi-user capabihties. Ron Williams has 
reported that after entering newcli ser: 
at the CLI, a message was output to the 
serial port saying new cli, and a prompt 
appeared. But it did not seem to be ac- 
tive because no corresponding window 
appeared on the Amiga's monitor. John 
Eric Hinkley cleared up that little 
mystery by saying that the Amiga serial 
port does not appear to respond to 
delimiters like CR. It seems you have to 
send 200 characters to get the serial port 
to give the line to the new cli. He wrote 
a small 9600-baud terminal program for 
his IBM PC that buffered what was 
entered, and when CR was pressed, it 
sent the line padded with extra spaces to 
bring it up to 200 bytes. He was able 
to get the machine to respond to such 
commands as dir. list, info, and so on. 
Running programs from the serial port 
proved problematic because they 'attach' 
themselves to the Amiga's keyboard, and 
their input/output cannot be reset for the 
serial port without encoimtering an error 
stating that ser: has already been attach- 
ed by another process. I'm sure we 
haven't heard the last word on this sub- 
ject, though. 

Other News 

A new Amiga magazine has debuted CEill- 
ed Amazing Computers. Word is that it 
is packed entirely with Amiga-specific ar- 
ticles and that it is off to a good start. 
Subscriptions are $21, "00 (in the US) and 
can be had by writing to PIM Publica- 
tions, P.O. Box 869, Fall River, MA 
02722, or calling (617) 679-3109. 

Charles Brannon, the COMPUTE! 
Amiga columnist and editor, has a 
regular presence on the Amigaforum. 
You can send ideas and comments to him 
care of PPN 76004,73 on CIS. 

Lastly, the following message should 
give you some idea of the changes in 
CBM's attitude towards its customers: 

#: 7214 S9/SoftwareDevelopment 

04-Feb-86 08:40:47 
Sb: REV. 1.1 MANUALS 
Fm: FRANK SCHWAB 73137,3142 
To: BELA 76703,3015 
Beia — Took your advtce and called Com- 
modore Software Support today. Lisa there 
told me that yes, even we non-developer 
scum who bought only the developers' 
manuals set, will get the revision 1.1 
manuals. Who at Commodore is respon- 
sible for this outrageous behavior, suppor- 
ting users after they buy Iheir machine, and 
providing software and manual updates? 
Absolutely unheard ofl BUT I LIKE ITIll! D 



The Walker 

1) Insert your COMAL disk in drive*. 

2) Type LOAD "064 COMAL*", 8 

3) Type RUN (starts COMAL) 

4) Type AUTO 

(COMAL provides the line numbers) 

5) Enter the program lines shown below 

(COMAL indents lines for you) 

6) Hit RETURN key twice when done 

7) Type RUN 

Watch an animated sprite hobble 
across the screen. Change the (99) 
in line 4S0 for really fast walking 

0010 setup 

0020 repeat 

0030 walking 

0040 until key$="q" //Q to Quit 

0050 // 

0060 proc setup 

0070 blue:=14| pink; = 10 

0080 wh!te:=l; blacki^O 

0090 define 'images 

0100 repeat 

0110 input "speed (1-10): ": speed 

0120 until 8peed>=l and speed<=10 

0130 background black 

0140 setgraphic 

0150 spriteback blue.pink 

0160 spritecotor l,white 

0170 spritesize l,false,fal3e 

0180 plottext 1,1, "press q to quit" 

0190 endproc setup 

0200 // 

0210 proc define'images closed 

0220 dim shape! of 64, c$ of 1 

0230 shapej(l:64):="'' 

0240 Bhape*(64):=chr|(l)//multicolor 

0250 c*:=zchrJ{0) 

0260 for x=22 to 63 do Bhape$(x):=c* 

0270 cj:=chr$(170} 

0280 for x=l to 21 do shape* (x):=c» 

0290 define 0,Bhape$ 

0300 c$:=chr»(20) 

0310 for x=22 to 42 do shapej(x):=ct 

0320 define l.shapej 

0330 define 3,8hapet 

0340 c«:=chrt(60) 

0350 for x=43 to 63 do shape$(x):=c* 

0360 define 2,8hape$ _ 

0370 endproc define'images 

0380 // 

0390 proc walking 

0400 for walk:=l to 319 div speed do 

0410 x:=walk*speed 

0420 y:=100-l-walk mod 4 

0430 spritepos l,x,y 

0440 identify l.walk mod 4 

0450 pause(99) 

0460 endfor walk 

0470 endproc walking 

0480 // 

0490 proc pause(delay) closed 

0500 for wait:=l to delay do null 

0510 endproc pause 

* If you don't have COMAL yet, order a 
Programmer's Paradise Package -tl9,9S. 
It includes the complete COMAL system 
plus over 400 pages of information. Add 
$5 more to get our 20 interactive lesson 
Tutorial Disk. Add *2 shipping. Visa/MC 
or US funds check accepted. Send to: 

COMAL Users Group USA 

6041 Monona Drive, Room 109 
Madison, WI 53716 
phone 608-222-4432 
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Extending the cruise 

More hardware and software 
for the musical Commodore 64 



by Tim Grantham 

Since my last article about music soft- 
ware and hardware for the 64 ('Cruising 
the Sea of 64 Music', November 1985), I 
have had the opportunity to examine 
some new products, and to take a closer 
look at some mentioned only briefly in 
that article. 

Melodian keyboard 

Melodian is primarily a manufacturer 
of keyboards, and their expertise shows. 
The Melodian Musical Keyboard looks 
good and feels good, the keys having 
quite the best action of all the add-on 
keyboards for the C-64 that I've tried. It 
also has a three-and-a-half octave range, 
which means much less switching of oc- 
taves from within the program. The 
keyboard has two connectors to the C-64: 
a large plug that is inserted into the user 
port, and a smaller one that plugs into the 
rear joystick port. 

The same straight-forward craftman- 
ship has been put into the accompanying 
software. The ConcertMaster program 
is completely menu-driven, and essential- 
ly emulates a three-track tape deck and 
polyphonic synthesizer. Each voice of the 
SID chip is assigned its own track, and 
each track can be recorded to, played 
back, monitored, muted, and so on, com- 
pletely independently. The usual pro- 
cedure is to record one track first, then 
record a second while listening to the first 
play back. A third track is recorded in the 
same fashion. This is deliberately reminis- 
cent of the way a piece is assembled at 
a professional recording studio, track by 
track, until all sixteen or thirty-two 
tracks have been recorded. You can also 
create your own sounds by changing any 
of the instruments provided by the pro- 
gram. The major features of the SID chip 
are all under your control, including the 
filters, synchronization, and ring 
modulation . 

I found the keyboard and software com- 
bination ideal for musical 'sketching'. 
Anything longer becomes a problem, 
because of the lack of editing functions. 



There is no way to change just one or two 
notes in what you've previously record- 
ed. But if you have enough digital dex- 
terity (no pun intended), it's very esisy to 
lay down a melodic line, then experiment 
with different harmonies while listening 
to the melody. Once I'm happy with my 
three-part arrangement, 1 store it to disk 
for later transcription to a full-featured 
music editor like Music Assembler 64 or 
Master Composer. 

Concert Master has a colourful, though 
simplified, score display that scrolls rapid- 
ly from right to left as the music is played. 
It's not of much use except to reinforce 
the relationship between the pitch of the 
notes and their position on the musical 
staff. 

Melodian also has an mstruction pro- 
gram called Rhythm Composer, that 
makes a game out of learning musical 
notation. The player is required to match 
a musical phrase played by the computer. 
The program is a little too precise, 
perhaps: a novice is likely to be frustrated 
with the rigidity of the timing. Human be- 
ings are not metronomes, and time values 
in music are not always exact. 
Nonetheless, this program can be 
valuable simply for the discipline it 
enforces. 

Melodian has also released Program- 
mer's Tool Kit, a book containing BASIC 
source listings of programs that read the 
musical keyboard and read and create 
music files. Another recent addition is the 
Melodian ScoreMaster, which prints out 
ConcertMaster files in musical notation. 
Any printer that can emulate the 1525, 
1515, or the MPS 803 in graphics mode 
can be used. 

MacMusic 

A fine program for the beginner is 
Passport Design's MacMusic, so named 

because it emulates the user interface of 
the Apple Macintosh, complete with drop- 
down menus and icons. You can do 
everything by just moving the pointer 
with the joystick to the appropriate spot 
on the screen and pressing the fire but- 
ton. It's a very smooth implementation. 



and the only frustration I encountered 
was with the slow speed of the pointer, 
as I moved it around the screen. 

You literally draw the music onto the 
screen (the pointer becomes a paint- 
brush). Each voice is drawn as a line in 
a different colour. The length of the line 
determines the duration of the note , and 
its vertical position on the screen defines 
its pitch. You can choose from a number 
of fixed sounds, and several different 
musical scales. You can have a lot of fun 
drawing in a blues scale, or the pentatonic 
scale, because 'wrong' notes are less ap- 
parent in these scales. 

Two other solid features of this pro- 
gram are the ability to change either the 
meter (number of beats per measure) or 
the tempo for any or all measures in the 
music, allowing complex rhythms to be 
played. You can also change the instru- 
ment being played in any bar, but there 
is no facility for creating your own 
sounds. 

This program is excellent if you like a 
'sandbox' approach to creating music. 
You can paint great swathes of 
polyphonic sound quickly and easily, with 
over a dozen different timbres. When you 
want to start entering individual notes, 
carefully timed and placed, however, the 
approach becomes awkward and time- 
consuming. A display of a piano keyboard 
runs up one side of the composing screen, 
so you know exactly where to draw the 
note. But it is no faster than it would be 
to write out what you want in musical 
notation. This is mitigated by the fact 
that, once the music has been entered, it 
is easy to change. You can edit your 
music note by note, or you can use the 
cut-and-paste functions to move around 
chunks of the score. This is especially 
useful when you want to repeat sections 
of the music. Once they have been cut out, 
they can be copied as many times as 
necessary. The immediate playback that 
the computer offers, combined with the 
ease of editing, make this a worthwhile 
program in many respects. However, I 
think that someone who already has 
musical training might prefer a program 
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with more a more utilitarian approach. 
Passport Design's also publishes Com- 
puter Hitware, arrangements of popular 
contemporary music on disk for the C-64. 
Current disks include selections by the 
Police, Van Halen, Duran EJuran, and 
others. AJso available is Computer Sheet 
Music, which teaches keyboard technique 
and musical notation by displaying songs 
on the screen in large-note format. The 
program works in conjunction with 
Passport Designs's MUSIC 64 keyboard, 
or any MIDI keyboard and interface. 

FastFingers 

In FastFingers, author Dan Laskowski 
has taken an approach entirely different 
from any I've seen before. He has utiliz- 
ed all the resources of the SID chip to 
create a performance lead synthesizer 
and sequencer. By combining all three 
voices into one, he has created 256 
remarkable sounds — 'presets' in syn- 
thesist's parlance. You can also create 
your own sounds, using the programs e.\- 
tensive control functions and built-in 
special effects, by overwriting the 
presets. These new presets can be saved 
to another disk. 

The list of special sound effects is im- 
pressive. It includes: 

• Flange detunes each of the oscillators 
with respect to the others, 

• Glide causes the pitch of each note to 
slide to the pitch of the next one. 

• Wah adds a wah-wah effect to the 
notes. 

• Tremelo causes a rapid oscillation in 
the filter cut-off frequency, giving the im- 
pression of a rapidly-varying loudness. 

• Weow makes an upward or downward 
slew of the pitch as the key is released. 

• Shftr results in a phase shift of the 
sound by detuning only one of the voices. 

The sequencer in FastFingers has also 
been modelled on those used by profes- 
sionals. These work very much like super- 
efficient tape recorders, but without any 
tape. To use the sequencer in FastF- 
ingers, you press the Rcord key, after 
setting the speed, and play the sequence. 
Press Stop when done. Now you can Play 
it (backwards or forwards), speed it up or 
down, punch in {change individual notes), 
Cut, Splice, and so on. You can also 
record arpeggios (series of notes taken 
from a single chord) that can be triggered 
from the keyboard, in much the same 
fashion. Laskowski claims you can store 
up to forty minides worth of music in the 
sequencer. 

Yet another unusual aspect of the pro- 
gram is that it uses the piano keyboard 



made by Mattel for its Intellivision home 
computer. The 64 's typewriter keyboard 
can also be used, but the Intellivision 
keyboard works very well. In one respect, 
it is even superior to the Melodian 
keyboard: it has forty -eight keys to the 
Melodian 's forty. Laskowski has created 
an adaptor for the keyboard, which is in- 
cluded with the software. If you can't find 
one of these keyboards locally, Laskowski 
himself has a limited number for sale (see 
address below). 

All of the above capabilities of Fast- 
Fingers are standard features on today's 
electronic instruments, and Laskowski is 
to be congratulated for successfully pro- 
gramming them into the C-64. 

Yet I have some doubts about the prac- 
ticality of the approach. The software has 
been designed very much with the per- 
forming musician in mind. It is possible 
to control the program without using a 
monitor, but lugging a C-64 and a disk 
drive from gig to gig may not be worth 
the trouble even for those musicians who 
are interested in the initial investment in 
the system. An SX-64 would solve the 
problem handily , but they are hard to get 
these days. 

Secondly, despite the great sounds 
Laskowski has coaxed out of the SID 
chip, the quality may just not be good 
enough for serious musicians. The SID 
has a signal-to-noise ratio of only 48 
decibels, and notoriously fickle filters. 
Laskowski does claim to have significant- 
ly improved the dynamic range of the SID 
by processing the sound through an add- 
on DBX expander. 

Laskowski should consider adapting his 
program for the IVIelodian keyboard, now 
that Melodian has released programming 
documentation for it. The Intellivision 
keyboards are going to be hard to get. 

"The organization of the controls in 
FastFingers is dense, but quite logical. 
The same cannot be said of the documen- 
tation , which suffers from a lack of clari- 
ty and friendliness. 

SID Editor 

As a sysop of the Commodore Music and 
Graphics forum on CompuServe, I can 
get some idea of the success of a music 
creation program from the number of 
files submitted. For a long time, Master 
Composer was the favourite, not only 
because of its ease of use and its editing 
features, but because it was one of the 
first to create 'stand-alone' files (files that 
can be transmitted and run as indepen- 
dent programs). Master Composer has 
been toppled from pre-eminence, though, 
by the appearance of many pieces created 
with Harry Bratt's SID Editor. This very 



powerful program can be found in AU 
About the Commodore 6A, volume 2, by 
Craig Chamberlain. Almost all the pro- 
grams in this book are available from 
COMPUTE! Publications on a disk. 

SID Editor gives you note-by -note con- 
trol over every aspect of the sound. This 
program pushes the SID chip to its limits. 
Almost every imaginable musical effect 
can be created: tricky time signatures, 
syncopated rhythms, tempo variations, 
portamento, vibrato, ties and slurs. The 
same goes for the creation of the sounds 
themselves, with the availability of such 
features as filter sweeps and pulse-width 
sweeps, detuning, transposition, and so 
on. 

But what really sets this program apart 
is that, in combination with the book, it 
can be used by either a total novice or a 
trained musician. The book provides a 
very good introduction to all the basics 
of musical notation and synthesizer 
technique. Almost every feature of the 
program can be accessed with a joystick. 
More experienced users can enter com- 
mands and note values through the 
keyboard. 

Each note is displayed in three ways: 
as one of the keys on a keyboard, as a 
note on a staff, and as a letter. You can 
change any aspect of any note anywhere 
in the piece. One very powerful feature 
is the ability to define up to 16 phrases 
of music that can be called or redefined 
at any time. They can even consist entire- 
ly o f commands , so that you could , for in - 
stance, call one phrase of notes with 
another phrase of commands, ringing the 
notes through a series of changes in key , 
articulation, tempo, and so on. In the 
hands of an expert, large pieces can be 
constructed very efficiently, conserving 
memory. 

Like Master Composer, files created 
with SID Editor can be added to, and 
controlled by, other programs. Individual 
voices can be turned on or off; the music 
can be stopped and restarted from where 
it left off; and individual sections of the 
music can be flagged, so that the calling 
program can synchronize its actions with 
the music. 

Four utility programs provided with 
SID Editor enable you to list the music, 
extract sections, append one or more files 
to another, and cross-merge files — use 
one of the voices of one file for the voice 
of another. This last is useful for rear- 
ranging the voices in one file. 

Music Assembler 64 

SID Editor is a very complete program, 
but even it does not have the power of 
MA64 by Nick Sullivan, so-called because 
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the music is written in a source code that 
has much in common with BASIC, and 
then assembled by the program into a 
playable 'object code'. MA64 is a commer- 
cial version, rewritten and greatly ex- 
panded, of Music Afisembler 64, a TPUG 
freeware program available on disk (C)$l. 

In addition to every music control 
feature of SID Editor, MA64 provides 
such arcane features as waveform 
scheduling, where each note can be set 
up to switch between different 
waveforms while it plays; pulse width 
vibrato, a controllable oscillation of the 
pulse width; and duration patterns, which 
work like a sequencer, enabling a series 
of pitches to be played in the same 
repeating rhythm. If you can think of 
some new tricks to teach the SID chip, 
MA64 even gives you a way to poke the 
SID directly from within the object code! 

One feature I particularly like is a 
variable delay on the vibrato. When 
vibrato is used on regular instruments — 
a flute, say — the vibrato is not added by 
the player until a second or two after the 
note is started. The only traditional in- 
strument that comes readily to mind 
where this is not done, is the pipe organ. 

MA64 is superior to SID Editor in its 

implementation of vibrato and glissando, 
because it defines the depth of the vibrato 
and the sweep rate of the glissando in 
terms of intervals, rather than frequen- 
cies. The depth of the vibrato in SID 
Editor must be adjusted as the base pitch 
of the note changes, because as the note 
gets higher, the musical interval defined 
by the difference in the upper and lower 
frequencies becomes smaller. To the ear, 
the depth of the vibrato becomes 
shallower, even though the frequency 
variation is the same. MA64, on the other 
hand, sets the depth of the vibrato as a 
fraction of an interval, which is indepen- 
dent of the base pitch of the note. To the 
ear, the vibrato depth stays the same, no 
matter how high or low the base 
frequency. 

This program is not for the novice: 
some knowledge of music is required. 
MA64 is a mini -language, and as such, 
can be a tittle daunting even to those who 
can read music, but who have little 
understanding of programming. Those 
who are familiar with .BASIC will find 
themselves in friendly territory though, 
for MA64 uses many of the statements 
found in BASIC. Below, I have listed a 
short sample program in MA64: 

10 sys B92 

20 [ 0] :tf=0: ;initialize 
transposition factor 



30 for la=1 to S 
40 gosub motif 

S0 tf-tf+1: .t tf 

60 next ia 

70 end 

80 /motif 

90 c3h:e :a:g:c4 :b3q:a:gh 

100 return 

This can be entered just like a BASIC 
program, using the built-in screen editor; 
you can load or save it, and you can even 
use editing utilities like POWER. The 
SYS in line 10 invokes the 'assembler', 
which generates music 'object code' from 
the succeeding statements. The program, 
when assembled, will play the note values 
in line 90 five times, transposing it up one 
semitone each time. 

Sullivan provides a tutorial program on 
the disk, and on-line help files, as well as 
SID Monitor, which displays what's hap- 
pening in all the SID's registers as the 
music is being played. 

it's been fun. . . 

All of the above programs, with the ex- 
ception of FastFingers, provide excellent 
arrangements of classical and contem- 
porary music as demonstrations, and 
complete, readable documentation. It's 
been a pleasure exploring all of these pro- 
grams. "Music hath charms ..." so they 
say, and that seems to be reflected in the 
generally high quality of music software 
for the Commodore 64. 

ConcertMaster, RhythmMaster, 
ScoreMaster, Programmer's Tool Kit, 
Musical Keyboard, by Melodian, Inc., 
970 W. McNob Road, Fort Lavderdaie, 
Florida 33309. ($29.95 US each for the 
software, $99.95 US for the keyboard). 

MacMuaic, by Passport Designs, 625 
Miramontes Street, Half Moon Bay, 
California 9^019 ($1,9.95 US). 

FastFingers by Dan Laskowski, See- 
Thru Enterprises, 10S82 Shenandoah, 
Windsor, Ontario N8R IBS. (519) 
735-2995 ($119.85 US for keyboard, adap- 
tor, and software; $59.90 US minus 
keyboard; $2i.95 US for software alone). 

AU About the Commodore 64, Vol. 2, by 

Craig Chamberlain. Published by Com- 
pute! Books, Inc., P.O. Box 51,06, 
Greensboro, North Carolina 27J,03 ($16.95 
US for the book, $12.95 US plus shipping 
for the disk). 

MA64.V2, by Nick Sullivan. Distributed 
by WilantaArts, 691,3 Barrisdale Drive, 
Mississauga, Ontario L5N 2H5 ($29.95 
Cdn.. $19.95 US). D 
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Commodore 128 Memory Map 



by Paul Blair 

and Jim Butterfield 

By this time, memory maps for the Commodore 128 are sprouting 
up all over the place. But on these pages, Aitstralian vDriterPaxd 
Blair gives ils a memory map with a difference. Paul has cross- 
referenced many locations on the 1'28 with their C-6i equivalents, 
so programmers who already have some familiarity with the 
layout of the 64 will more readily be able to get their bearings 
on the new machine. Many thanks to Paul for sharing this work 
vrith Its. 

» * + 

This memory map has been prepared to assist programmers 
understand more about the structure of BASIC 7.0 as im- 
plemented in the Commodore 128 computer. As the machine 
also has a C-64 operating mode, with BASIC 2.0, the map 
reflects common entry points as far as possible. 

I have drawn on work done by Jim Butterfield. Jim had access 
to early releases of the C-128, and was generous in supplying 
information to friends. Without his assistance, this map would 
have been a long time coming. My thanks to him. 

The information here represents our ideas of what is in Release 

of the C-128 BASIC and Kernal ROMs. Consider this Version 

1 of the map: it was completed in December, 1985, and it is poss- 
ible that ROM revisions after that date will invalidate some of 
the data. It has not been the policy of Commodore to release 
memory maps to the general public, so we offer this map to help 
you get more from your Commodore computer. 

BANKO 



Label C-128 C-64 



D6510 

BANK 

PC-HI 

PC-LO 

S-REG 

A-REG 

X-REG 

y-REG 

STKPTR 

INTEGR 

CHARAC- 

ENDCHR 



TRMPOS 

VERCK 

COUNT 

DIMFLG 

VALTYP 

INTFLG 

GARBFL 

SUBFLG 
INPFLG 

TANSGN 

POKER 

LINNUM 

TEMPPT 

LASTPT 

TEMPST 

IN0EX1 

IN0EX2 

RESHO 

TXTTAB 



0000-1 

0002 

0003 

0004 

0005 

0006 

0007 

OOOB 

0OO9 

0OO9 

0009 

OOOA 



OOOB 
OOOC 
OOOD 
OOOE 
OOOF 

0010 

0011 

0012 
0013 

0014 

0015 

0016-17 

0018 

0019-1A 

0018-23 

0024-25 

0026-27 

0028-2C 

002D-2E 



0000-1 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 



Flag: scan lor 
quote at enO 
Ot siring 
0009 
OOOA 
OOOB 
OOOC 
OOOD 

OOOS 

OOOF 

0010 
0011 

0012 

0014-15 

0016 

0017-18 

0019-21 

0022-23 

0024-25 

0026-2A 

002B-2C 



Description 

\I0 port, similar lo 0-64 

Monitor use. Program counter MSB 
Program counter LSB 
Processor status 
Accumulator (,A) store 
X-regisIer (.X) store 
Y-regisler (.Y) slore 
Stack pointer (SP) store 

Search character 



Screen column from last tab 

Flag = LQAO. 1 = VERIFY 

Input buffer plr/# of sutiscrtpts 

Flag detault array dimension 

Variable type: SFF = stnng. 

SOD = numeric 

Var type: S80 = inleger, $00<=lloating 

point (FLP) 

Flag: DATA scan/LIST quote/gartjage 

collection 

Flag, subscript ref/user lunction call 

Flag: $00 = INPUT, $40 = GET, 

S9B = READ 

Flag: TAN sign/comparison result 

Current \I0 device # 

Integer value (line », GOTO, POKE etc) 

Pointer: next string stack entry 

Pointer: current string stack entry 

Stack: 9 bytes tor 3 string pointers 

General purpose pointer 

General purpose pointer 

Workspace used by multiply and divide 

Pointer: start of BASIC (for Bank 0) 



VARTAB 

ARYTAB 

STREND 

FRETO 

FRESPC 

MAXMM1 

CURLIN 
TXTPTR 

FORM 

FNDPTR- 

DATLIN 

DATPTR 

INPPTR 

VARNAM 

VARPNT 

FDECPT- 

LSTPNT 

ANDMSK" 

FORPNT- 

EOHMSK" 

VAHTXT 

OPPTR- 

OPMASK 

GHBPNT 

TE(v1PF3" 

DEFPNT- 

DSCPNT 

HELPER 

JMPER 

TEMPF1 

PTARGI 

PTARG2 

STR1 

STR2 

POSITN 

MATCH 

ARYPNT 

HIGHDS' 

HIGHTR 

TEMPF2 

DECCNT 

GRBTOP 

DPTFLG- 

LOWTR- 

EXPSGN 

FACEX 

FACHO 

FACSGN 

ARGEXP 

ARQHO 

ARGSGN 

ARtSGN 

FACOV 

FBUFPT 

AUTINC 

MVDFLG 

KEYNUM 

NOZE- 

SPRNUM' 

HULP 

KEYSI2- 

SYNTMP 

DSDESC 

TOS 

RUNMOD 

PARSTS 

POINT' 

PARSTX 

OLDSTK 



002F-30 
0031-32 
0033-34 
003536 
0037 36 
0039-3A 

003B-3C 
003D-3E 

003F 

003F-4A 

0041-42 

0043-44 

0045-46 

0047-4B 

0049-4A 

0049-4A 

004B-4C 



004D-4E 



004 F 
0050-51 



0052-0054 

OOSS 

0056-58 

0059 

TEMPF1-I-2 

TEMPF1+2 

TEMPF1-f4 

T£(^PF1-f7 

TEMPFli-10 

TEMPF1-H1 

005A 

005A-5B, 

005C005D 

005E 

OOSF-60 

0061 



0062 

0063 

0064-67 

0068 

006A 

0088-6E 

006F 

0070 

0071 

0072-73 

0074 

0076 

0077 



0078 

0078 

0079 

0O7A-7C 

007D-7E 

007F 

0080 

0080 

0081 

0082 



002D-2E 
002F-30 
0031-32 
0033-34 
0035-36 
0037-38 

0039-3A 
007A.7B 

NA 

NA 

003F.40 

004142 

0043-44 

004546 

0047-48 



0049-4A 
004B-4C 



004 D 
004e-4F 



0050-51 
005456 



0058-59 

0058-59 

005A-5B 

005C-0060 

005D-5E 

005F 



0060 

0061 

0062-65 

0066 

0069 

0Q6A-O06O 

006E 

006F 

0070 

0071-72 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

(see 9D| 

NA 

NA 

NA 

NA 



Qraphlc zero page storage 

COLSEL 0083 NA 

MULTCl 0084 NA 

MULTC2 0085 NA 

FG 0086 NA 

SCALEX 0087 NA 

SCALEY 0089 NA 

STOPNB 008B NA 

GRAPNT 008C-8D NA 

VTEMPl 008E NA 

VTEMP2 0O8F NA 

STATUS 0090 0090 



Pointer start of variables (Bank 1) 

Pointer: start of arrays 

Pointer: end of arrays -i- 1 

Pointer: string storage (moving down) 

Utility string pointer 

Pointer. limit of memory (Bank 1 in 

0123) 

Current BASIC line number 

Pointer: BASIC work pointer (CHRGET 

etc} 

Used by PRINT USING 

Pointer to item found by search 

Current DATA line number 

Current DATA address 

Vector. INPUT routine 

Current BASIC variable name 

Current BASIC variable address 



Mask used lor comparisons 
Pointer: index variable (or FOR/NEXT 
Mask used lor comparison 
Pointer lo operator table 

fvlask used for comparison 
Pointer used for lunction definition 



Pointer: used for string operations 

Flag: HELP or LIST 

S4C (JMP) + address ot function 

Multiple defined for INSTR 



Used lo define arrays (DIM) 
Pointer used for block transler 
Pointer also used for block transfer 
Temporary FLP Accumulator (Accum) 
# decimal point digits in conversions 
Flag: used lo test for decimal pt in 
strings 



Sign of exponent 

FLP Accum #1 exponent 

FLP Accum #1: mantissa 

FLP Accum #1. sign 

FLP Accum #2: repeat as per FLPA #1 



Sign comparison, Accum *1:*2 

FLP Accum #1 rounding 

Pointer: cassette buffer 

Increment value for AUTO ($00 -off) 

Flag: 10K hi-res aliocaled 

Key chosen 

Leading zero counter 

Move sprite and sprite temporary 

Counter 

Key command length 

Temp lor indirect loads 

Descriptor for disk error (DS$) 

BASIC pseudo slack pointer 

Flag: RUNi'direct mode 

Status word lor DOS parser 

Pointer to decimal point 



Current colour selected 



Scale factor m X 

Scale factor in Y 

Slop PAINT if not same colour 

Utility pointers 



S" = status 
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STKEY 


0091 


0091 


SVXT 


0092 


0092 


VERCK 


0093 


0093 


C3PO 


0094 


0094 


BSOUR 


0095 


0095 


SYNO 


0096 


0096 


XSAV 


0097 


0097 


LDTND 


0098 


0098 


DFLTN 


0099 


0099 


DFLTO 


009A 


009A 


PRTY 


OOSB 


0098' 


DPSW 


009C 


009C 


MSGFLG 


009D 


009D 


PTR1 


009E 


0C9E 


TV 


009E 




PI«2 


0O9F 


009F 


T2" 


009F 




TIME 


00A0-A2 


00A0-A2 


PCNTR 


00A3 




BSOUR 1 


O0A4 




COUNT 


00A5 


00A5 


CNTDN' 






BUFPNT 


00A6 


00A6 


INBIT 


00A7 


00A7 


BITCI 


C0A8 


00A8 


RINONE 


00A9 


O0A9 


RIDATA 


00 AA 


OOAA 


RIPITY 


OOAB 


OOAB 


SAL 


OOAC-AD 


OOAC-AD 


EAL 


OOAEAF 


OOAE-AF 


CMPO 


oofin 


0030 


TEMP 


00B1 




TAPE1 


00B2 




BITTS 


0OB4 


00B4 


NXTBIT 


00B5 


00B5 


RODATA 


00B6 


00B6 


FNLEN 


0OB7 


0OB7 


LA 


00B8 


00B8 


SA 


0089 


00B9 


FA 


OOBA 


OOBA 


FNADH 


OOBBBC 


OOBB-BC 


ROPRTY 


OOBD 


OOBD 


OCCHAR- 


008D 


OOBD 


FSBLK 


OOBE 


OOBE 


MYCH 


OOBF 


OOBF 


DRIVE- 






CASI 


OOCO 


OOCO 


STAL 


00C1C2 


00C1-C2 


MEMUSS 


O0C3-C4 


00C3-C4 


TMP2 


O0C5 


NA 


BA 


00C6 


NA 


FNBANK 


00C7 


NA 


RIBUF 


00C8-C9 


00F7-F8 


ROBUF 


OOCA-CB 


00F9-FA 


Global screen editor variables 


KEYTAB 


OOCC-CD 


00F5-0QF6 


IMPARM 


OOCE-CF 


NA 


NDX 


OODO 


00C6 


KYNDX 


00D1 


NA 


KEYIOX 


00D2 


NA 


SHFLAG 


00D3 


028D 


SFDX 


00D4 


OOCB 


LSTX 


O0D5 


00C5 


CRSW 


00O6 


OODO 


MODE 


00D7 


NA 


GRAPHM 


OODS 


NA 


CHARE N 


00D9 


NA 


SEDSA 


OODADD 


NA 


SEDT12 


OODE-DF 


NA 


KEYVAR 


OODA-DF 


NA 


LOCAL screen editor variables (40/80 i 


PNT 


OOEO-El 


ODD 1 -02 


USER 


OOE2-E3 


00F3-F4 


SCBOT 


0OE4.E7 


NA 


5CTO 


ODES 


NA 


5CLF 


00E6 


NA 


SCOT 


0OE7 


NA 


LSXP 


00E8-E9 


O0C9CA 


INDX 


OOEA 


00C8 


TBLX 


OOEB 


0006 


PNTR 


OOEC 


0003 


LINES 


OOED 


NA 



Flag: STOP anO RVS keys 

Tape liming conslanl 

Flag: $00 -LOAD. $01 -VERIFY 

Flag: serial character awaiting oulpLit 

Actual serial characier wailing 

Flag: end o( dala block Irom tape 

Temporary store during mpui 

|tape/RS232) 

* open lilasrtndex inio (ile table 

Delault input device (0 = keyboard) 

Delault output (CMD) device 

(3 = screen) 

Cassette parity dunng write 

Flag: byte read complete 

I/O messages $00 -nil. S40 = errors. 

S80-all 

Cassette error pass 1 

Temp workspace 1 

Cassette error pass 2 

Temp workspace 2 

Jiffy clock 

Cassette/serial temp 

Serial routine temp stor^ 

Senalfcasselle lemp store 

Cassette butler pointer 

RS232 receiver input bil storage 

RS232 receiver bit count in 

RS232 receiver Hag for start bit ctieck 

RS232 receiver byte buffer 

RS232 receiver parly storage 

Pointer to tape Sutler 

Tape end adOress/end of program 

Tape timing constant 

Address ol tape butter 

RS232 transmit bit count 

RS232 transmit next bit to send 

RS232 transmit byte butter 

Number of characters ;n file name 

Current logical lile 

Current secondary address 

Current device 

Pointer to lile name 

RS232 transmit priority 

Output ctiaracter 

# blocks left to read/write 

Temp to collect byte 

Cassette motof conlrol (lag 

I/O start address 

Pointer lor general use 

Tape read/write data 

Bank lor current LOAD/SAVEWERIFY 

Bank where current tile name {lor 

FNADR) 

RS232 input buller addresses 

RS232 output butter addresses 



Keyboard decode pointer (Bank 15 in 

0-128) 

PRJMM utility string pointer 

Number ol characters in keyboard 

butler 

Number ol programmed ctiars wailing 

Flag index to lu notion key string 

Flag. Bhitt key $00 = no shitt 

Copy ol LSTX lor rollover 

Last key pressed 

Input Irom screen/keyboard 

Flag: 40/80 columns ($00 = 40 

columns) 

Flag: text/graphic mode 

Characier base: $00 » ROM. 

S04 = RAM 

Pointers MOVLIN routine (2 addresses) 

Pointers SAVPOS 

Programmable key variables 



Pointer to screen line/cursor 

Colour line pointer 

Window lower limit 

Window upper limit 

Window left margin 

Window right margin 

Input cursor log (row, column) 

Current input line end 

Position of cursor on screen line 

Row where cursor lives 

Max number ol screen tines 



COLUMN 


OOEE 


NA 


DATAX 


OOEF 


00D7 


LSTCHR 


OOFQ 


NA 


COLOR 


0OF1 


0286 


TCOLOR 


00F2 


NA 


RVS 


00F3 


00C7 


QTSW 


00F4 


00 D4 


INSRT 


OOFS 


0OO8 


INSFLG 


00F6 


NA 


LOCKS 


00F7 


NA 


SCROLL 


OOFS 


NA 


BEEPER 


00F9 
00F9-FA 


NA 
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FBUFFR 


0100-FF 


XCNT 


0110 


D0SF1L 


0111 


DOSDS1 


0112 


D0SF1A 


0113-14 


D0SF2L 


0115 


D0SDS2 


0116 


D0SF2A 


0117-18 


DOSOFL 


0119-lA 


DOSOFH 


011B-1C 


DOSLA 


011D 


DOSFA 


011E 


DOSSA 


011F 


DOSRCL 


0120 


[XiSBNK 


0121 


DOSDID 


0122-23 


DIDCHK 


0124 


PRINT USING work ar 


BNR 


01 2S 


ENR 


0126 


DOLR 


0127 


FLAG 


0123 


SWE 


0129 


USGN 


012A 


UEXP 


012B 


VN 


01 2C 


CHSN 


0120 


VF 


01 2E 


NF 


01 2F 


POSP 


0130 


FESP 


0131 


ETOF 


0132 


CFORM 


0133 


St^O 


0134 


BLFD 


0135 


BEGFO 


0136 


LFOR 


0137 


ENDFO 


0138 
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BUF 


O20O-A0 


0200-58 


FETCH 


02A2.AE 


NA 


FETVEC 


02AA 


NA 


STASH 


02AF-BD 


NA 


S1AVEC 


02B9 


NA 


CMPARE 


02BE-CC 


NA 


CMPVEC 


02C8 


NA 


JSRFAR 


02CD-E2 


NA 


JMPFAR 


02E3-FB 


NA 




02FC-FD 


NA 
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Max number ot screen columns 

Current char to print 

Previous char printed (loi' ESC test) 

Current colour to print 

Saved attribute to print (INST/DEL) 

Flag reverse mode on/off 

Flag quote mode 

Flag: insert mode (>0"# inserts) ' 

Flag: aulo-insert mode ($OQ = ofl) 

Disable SH I FT/C=, CTRL-S 

Disable screen scroll, line linker 

Disable CTRL-& (bell) 

UNUSED 



Processor stack area 

DOS loop counter 

DOS tilename 1 lengtti 

DOS disk drive 1 

DOS lilename 1 address 

DOS lilename 2 length 

DOS disk drive 2 

DOS lilename 2 address 

BLOAD/BSAVE start address (SA) 

B^AVE ending address (EA) 

DOS logical address 

DOS physical address 

DOS secondary address 

DOS record length (REL liles) 

DOS Bank # 

DOS disk ID 

Disk ID check 



Pointer: beginning number 

Pointer: end number 

Flag: dollar 

Flag: comma 

Counter 

Sign exponent 

Pointer: exponent 

# digits belore decimal point 
Flag: lustily 

# ot positions belore decimal point 

# ol positions after decimal pomt 
Flag, plus or minus 

Flag: exponent 
Switch 

Charactef counter 
Sign number 
Ftag: blank/asterisk 
Pointer: beginning of lield 
Length of lormat 
Pointer: end of lield 



BASIC input butler 
Bank PEEK subroulne 

Bank POKE subroutine 

Bank compare subroutine 

JSR to anolher Bank 
JMP to another Bank 
Function execute hook 
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lEHROR 


0300-01 


0300-01 


Vector to S4D3F/SE38B: output error 


message 








IMAIN 


0302-03 


0302-03 


Vector to S4DC6'$A483: main system 
loop 


ICRNCH 


0,104-05 


0304-05 


Vector to S430D/SA57C: lokenize 
routine 


IQPLOP 


0306-07 


0305-07 


Vector to S5151/$A71A: LIST routine 


IGONE 


0308-09 


030809 


Vector to $4AA2/SA7E4 RUN routine 


lEVAL 


030A-0B 


030A0B 


Vector to $7eDA/SAE86: eval rouline 


lESCLK 


030C-OD 


NA 


Vector to $4321/NA, escape token 
crunch 



lESCPR 


03QE-0F 


VA 




lESCEX 


0310-11 


MA 




0312-13 


^A 


CINV' ' 


0314-15 SAME 


CBiNV 


0316-17 FOR 


NMINV 


0318-19 C64 


lOPEN 


031A-1B 




ICLOSE 


031C-1D 






iCHKIN 


031E-1F 






ICKOUT 


0320-21 






ICLRCH 


0322-23 






IBASIN 


0324-25 






IBSOUT 


0326-27 






ISTOP 


0328-29 






IGETIN 


032A-2B 






ICLALL 


032C-2D 






EXMON 


032E-2F t 


JA 


ILOAD 


0330-31 




ISAVE 


0332-33 




CTLVEC 


0334-35 r 


JA 


SHFVEC 


0336-37 h 


JA 


ESCVEC 


0338-39 t 


JA 


KEYVEC 


033A-3B h 


JA 


KEYCHK 


033C-3D r 


JA 


DECODE 


033E-49 P 


JA 


KEYD 


034A-53 C 


277-80 


TABMAP 


0354-5D f 


JA 


BITABL 


035E-61 ^ 


JA 


LAT 


0362-6B 


259-62 


FAT 


036C.75 


263-6C 


SAT 


0376-7F 


26D-76 


CHRGET 


0380-9E 


073-eA 


CHRGOT 


0386 


079 


QNUM 


0390 


07C 


Subroutines to fetch Irom Ht 


M Ban 


iNSRAO 


039F ^ 


A 


INSR01 


03AB ^ 


A 


INDRAl 


03B7 h 


A 


INDRA2 


03C0 h 


A 


ZERO 


03D2 ^ 


A 


CUBNK 


0305 ^ 


A 


TMPDES 


03D6 h 


A 


FNBNK 


03DA N 


A 


SAVSIZ 


03DB K 


A 


BITS 


03DF N 


A 


SPTMP1 


03E0 N 


A 


SPTMP2 


03E1 N 


A 


FG-BG 


03 E2 N 


A 





FG-MC1 



03 E3 



NA 



Vector 10 SS1CD/NA: escape loken 

print 

Vector to S4BA9/NA: execule vector 

Unused (SFFFF) 

Vector to SFA65/IEA31: IRQ 

Vector to IB003/$FE66: Breal( interrupt 

Vector to SFA40/$FE47- Nl^l inlerrijpt 

From SFFCO to $EFBD/$F34A: OPEN 

routine 

From SFFC3 to SF18B;$F291: CLOSE 

routine 

From SFFC6 to SF106;$F2OE: CHKIN 

routine 

From SFFCO to SF14C(SF2S0: 

CHKOUT routine 

From SFFCC to $F226/SF333: 

CLRCHN routine 

From SFFCF to $EF06/SF1S7; CHRIN 

routine 

From $FFD2 to $EF79/$F1CA. 

CHROUT routine 

From SFFEI to SF66E/SF6ED: STOP 

routine 

From $FF£4 to $EEEB«F13E; GETIN 

routine 

From $FFE7 to $F222/$F32F CLALL 

routine 

Vector to SB006/NA: Monitor 

Vector to SF26C/$F4A5: LOAD 

Vector to SF54E/SF5ED: SAVE 

Vector to SC7B9;NA: Print CTRL ctiars 

Vector to SCB05/NA Print SHIFT chars 

Vector to SC9C1/NA; Pnnl ESC ctiars 

Vector to SC5E 1/NA: keyscan logic 

Vector to SC6AD/NA: store key 

Vector to SFABOJNA keyboard matrix 

tables 

IRQ Keyboard buffer 

Tab stop bits 

Line wrap bits 

Logical lile table 

Device number table 

Secondary address table 

CHRGET subroutine 

CHRGOT entry 

Crieck ior number 



Shared RAM fetch subroutine (S03A6) 

Shared ROM fetch subroutine ($03 B2) 

INDEX' indirect fetch 

INDEX2 indirect letch 

Numeric constant for BASIC 

Set by BANK cmd for SYS POKE 

PEEK 

Temp tor INSTR 

Bank ptr for string-number conversion 

Temp work area for SSHAPE 

Accum ffl overflow digit 

Temps for SPRSAV 

Packed fore/background colour 

nybbles. 

Packed fore/multicolour 1 nybbles 



BITNUKfl 


0A15 


0298 


RS232 * bits to send 


BAUDOF 


0A16-17 0299-9A 


RS232 baud rate full bit time 


HIDBE 


OAIB 


029B 


RS232 receive pointer 


RIDBS 


0A19 


029C 


RS232 input pointer 


RODBS 


0A1A 


029D 


RS232 transmit pointer 


R0D8E 


OAIB 


029E 


RS232 send pointer 


SERIAL 


0A1C 


NA 


Flag; fast serial internal/external 


TIMER 


0A1D-1F NA 


Decrementing jiffy register 


XMA 


0A20 


0289 


Keyboard buffer size 


PAUSE 


0A21 


NA 


CTRL-S flag 


RPTFLG 


0A22 


028A 


Flag: key repeat ($80-al!. S40-none) 


KOUNT 


0A23 


02BB 


Delay between key repeats 


DELAY 


0A24 


028C 


Delay before key repeats 


LSTSHF 


0A25 


028E 


Delay between SHIFT(C = toggles 


BLNON 


0A26 


OOCF 


Cursor mode: $00 = blink. SFF = steady 


BLNSW 


0A27 


OOCC 


Cursor blink enable: S00 = (lash 


BLNCT 


0A28 


OOCD 


Cursor blink counter 


GDBLN 


0A29 


OOCE 


Character under cursor 


GDCOL 


0A2A 


0287 


Cursor colour belore blink 


CURMOD 


0A2B 


NA 


VDC cursor mode (when enabled) 


VM1 


0A2C 


NA 


VIC text screen/char base pointer 


VM2 


0A2D 


NA 


VIC bit map base 


VM3 


0A2E 


NA 


VDC text screen base 


VM4 


0A2F 


NA 


VDC attributes base 


LINTMP 


0A30 


NA 




SAV80A 


0A31 


NA 


60 col routines work area 


SAV80B 


0A32 


NA 




SAV80C 


0A33 


NA 




SAV80D 


0A34 


NA 




CURCOL 


0A35 


NA 


VDC cursor colour before blink 


SPLIT 


0A36 


NA 


Spill screen raster value 


FNADHX 


0A37 


NA 


Save .X during Bank operations 


PALCfMT 


0A38 


NA 


Jiffy adiustment (or PAL systems 


MONITOR stores (C-IZB only) 




XCNT 


0A80 




Compare buffer 


HULP 


OAAO 






FORIVIAT 


OAAA 






LENGTH 


OAAB 






MSAL 


OAAC 






SXREG 


OAAF 






SYREG 


OABO 






WRAP 


0AB1 






XSAVE 


0AB2 






DIRCTN 


0AB3 






TEMPM 


QAB4 






CURBNK 


OACO 


NA 


Current function key ROM bank 


PAT 


0AC1 


NA 


Physical address table 


TBUFFR 


OBOO-BF 


033C-FB 


Cassetle tjuffer 


RS232I 


OCOO-ODFF 


RS232 I/O buffers 


RS2320 


OEOO-OFFF 


System spntes 


PHKBUF 


1000-09 


NA 


Programmed key lengths 


PHKDEF 


100A-FF 


NA 


Programmed key lengths and 



DOSSTR 1100-1130 

Graphics variables 

1131-1138 

Line drawing variables 
1139-1148 

Angle routine variables 

1149-114F 



dednifions 

DOS outpul buffer 



BANKO 



circle drawing variables or general use variables 
or shape and move shape or graphics variables 



VICSCR 


040O-O7E7 
07F8-07FF 






0eO0-09FF 


NA 


Absolute Kernsl Varfiblei 




SYSVEC 


0AO0-OAO1 


NA 


DEJAVU 


0A02 




PALNTS 


0A03 




INSTAT 


0A04 




MEMSTR 


0A05-06 


0281-82 


MEMSIZ 


OA07-08 


0263-84 


IRQTMP 


0A09-0A 


029F-AO 


CASTON 


OAOB 


02A2 


KIKA26 


OAOC 


02A3 


STUPID 


OAOD 


02A4 


TIMOUT 


OAOE 


NA 


ENABL 


OAOF 


02A1 


M51CTR 


QA10 


0293 


M51CDR 


0A11 


0294 


M51AJB 


0A12-13 


0295-96 


RSSTAT 


0A14 


0297 



40-cofumn screen memory 
Sprite identify area 
BASIC pseudo stack 



Veclor BASIC restart 

Kernal wafm/cold Start status vector 

PAUNTSC system flag 



Bottom of memory pointer 
Top of memory pointer 
Save for IRQ during tape 
TOD sense during tape 
Tape read temp 
Tape read IRQ indicator 
Fast serial timeout flag 
RS232 enables 
RS232 control register 
RS232 command register 
RS232 user baud rate 
RS232 status register 





1150-1 16F 




ADR AY 1 


t17A-117B 


0003-4 


ADRAY2 


117C-117D 


OOOS-6 


LPEN 


11E9-11EA 


NA 


OLDLIN 


1200-01 


003a-3C 


OLDTXT 


1202-03 


003D-3E 


PUCHRS 


1204-1207 


NA 


ERRNUM 


1208 


NA 


ERRLIN 


1209-120A 


NA 


TRAPNO 


1 208-1 20C 


NA 


TMPTRP 


120D 


NA 


ERRTXT 


120E 




TEXTTP 


1210-11 




MAXMMO 


1212-13 




TMPTXT 


1214-15 




USFiPOK 


1218-1A 


0310-12 


RNDX 


121B-1F 


008B-8F 


Music stores 






1220-1271 




Interrupt Stores 






1276-1280 





Vector to FLP-fixed routine ($84B4) 

Vector to Rxed-FLP routine {ST93C) 

Light pen X,Y values 

Previous BASIC line number 

Pointer BASIC stalemeni (or CONT 

PRINT USING cliars { .,$) 

ER = Error typ« 

EL = Error line r^umber (FFFF No 

error) 

Line to go to on error {FFxx none) 

Hold trap # temp 

End of BASIC (Bank 0) 
BASIC program limit SFFOO 
Used by DO loop 
USR program jump 
HND seed value 
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Sound Stores 






CROP 


4CB6 


AFE6 


Perform OR 




12B1-12FF 






ANDOP 


4089 


AFE9 


Perform AND 


START 


ICOI 


oeoi 


Normal start of BASIC ie« 


DOREL 


4CB6 


B016(S/R) 


Perform COMPARE 


BASIC 










4D2A 


C474 


Ptint ■■READY " 




20O0-3FFF 




Screen memory (fii-res) 


ERROR 


4D3F 
4DAF 
4DC6 




Output error (50300) 

BREAK 

Ready for BASIC (10302) 




4000.FBFF 




HAM memory (hi-res) 


MAIN 


A4S0 










HOHUM 


4DCD 




Ready (SAFA5) 


BANK 1 






MAINl 
Lt^lKPRG 


4DE2 
4F4F 


A49C 
A533 


l-iand'e new line 
Rechain lines ($AF87) 










INLIN 


4F93 
4FAA 


A560 


Get BASIC line 
Searcti BASIC slack 


0400-FBFF 






BASIC variables, arrays, strings 




4FFE 
5017 
5047 




Insert in slack 

Check if room for more 

Copy stack pointer 


BANK 14 








5050 
5059 




Set slack pointer 
Delete from stack 










FNDLIN 


5064 


A613 


Find BASIC line (SAF8D) 










LINGET 


5OA0 


A96a 


Get FLP number (SAF9F) 










LIST 


50E2 


A69C 


Perform LIST 


Same as Bank 15, except: 






QPLOP 


5151 


A6C9 


LIST subroutine (S0306) 




DOOODFFF 




Character generator ROM (same as 


ESCPR 


51 CO 




Escape token print (S030E) 








C-64) 


fJEW 


51 D6 


A642 


Perform NEW (SAF84) 










RUNC 


51F3 


A6S9 


Get ready to RUN (SAF7E) 










CLEAR 


51F8 


A6SE 


Perform CLR (SAF81) 


BANK 15 






LDCLR 
STXPT 


523B 
5354 


A677 
A68E 


Reset stack 

Bach up text pointer 










RETURN 


5262 


A8D2 


Perform RETURN 










DATA 


528F 


A8F8 


Perform DATA^BEND 




4000-CFFF 


AOOOCOOQ 


BASIC ROM 


REM 


5290 


A93B 


Perform REM 




DOO0-DO3O 




40-col Video chip 8S64 (Same as 64) 


DATAN 


52A2 


A906 


Scan 10 next statemenl 




D400-D41C 




SID sound chip 6581 (Same as 64) 


REMN 


52 AS 


A909 


Scan la next line 




D500-O50A 


NA 


MMU 8722 memory seluD registers 


IF 


52CS 


A928 


Perform IF 




0600 0601 


NA 


80-colLmn CRTC 




5320 


NA 


Search/skip BEGIN/BEND 




O800O8E7 




Colour nybbles (Same as 64) 




53 7C 


NA 


Skip string constant 




OCOOOCOF 




CIAI 6526 (IRQ) (Same as 64) 




5391 


NA 


Perform ELSE 




0000 ODOF 




CIA2 6526 (NMI) (Same as 64) 


ONGOTO 


53A3 


A94B 


Perfonn ON 




DFOO-DFOA 


NA 


DMA controller 


LET 


53C6 


A9A5 


Perfonn LET 




EOOO-FEFF 


EOOOFFFF 


Kernal ROM 




54F6 




Check siring location 




FF05-FFFF 


FF81-FFFF 


ROM; transfer, lump laWe 


PHINTN 


553A 


AA80 


Pertotm PRINT# 










CMD 


5540 


AA86 


Perform CMD 










PRINT 


5S5A 


AAAO 


Perform PRINT 


BASIC 7.0/2.0 ROM Routines 


GET 


5600 
5612 


AB7B 


Print format character 
Perform GET 










INPUTN 


5648 


ABAS 


Perform INPUT* 










INPUT 


5662 


ABBF 


Perform INPUT 


Label 


B7.0 


B2.0 


Description 


QINLIN 


569C 


ABBF 


Print ■'?■■ and take input 










READ 


56A9 


AC06 


Perform READ 










NEXT 


57F4 


AD1E 


Perform NEXT 


BCOLD 


4000 


AOOO 


J MP COLD START ($4023) Slarl of 


DIM 


587B 


Boei 


Perform DIM 








Basic ROMs 


SYS 


5885 


E12A 


Perform SYS 




4003 


A003 


MP WARM START (S4009) . 




58B4 


NA 


Perform TRON 




4006 




JMP SA84D IRQ S/R 




58B7 


NA 


Perform TROFF 


BASSFT 


4009 


E37B 


Warm start routine 




58BD 


NA 


Perform RREG 


INIT 


4023 


E394 


Cold slart routine 




5975 


NA 


Perform AUTO 


INITCZ 


4045 


E3BF 


Initialize BASIC 




5986 


NA 


Perform HELP 




4112 


NA 


Bell 




59AC 


NA 


Place help marker 




41 7A 


NA 


Set preconfiguralion registers 


Gosua 


59CF 


A883 


Perform GOSUB 




41BD 


NA 


Set up sprue movement tables 


GOTO 


S9DB 


ABAO 


Perform GOTO 


INITMS 


4198 


E422 


Print ■COMMODORE Basic 7 " 




SAID 




Push return address to slack 


IN!TV 


4261 


E453 


Set BASIC links initialize vectors 




SA3D 




Perform GO 


INiTAT 


4279 


E3A2 


CHRGET routine to move to S03B0 


CONT 


5A60 


Ae57 


Perform CONT 




42CE 


NA 


Indirect fetches: from ($50) Bank 


RUN 


5A9B 


A871 


Perform RUN (SAF7B) 




42D3 




from (S3F) Bank 1 


NEWSTT 


SAA6 




Get next statement (SAF99) 




42DB 




from ($52) Bank 1 


RESTRE 


5ACA 


ABID 


Perform RESTORE (AF9C) 




42DD 




from ($5C) Bank 


SETEXC 


5AE1 








42E2 




from (S5C) Bank 1 




SAF8 


NA 


Perform RENUMBER 




42E7 




from (S66) Bank 1 




SBAE 


NA 


RENUMBER (continued) 




42EC 




from ($61) Bank 




SBFB 


NA 


Scan program 




42F1 




from ($70) Bank 




SD19 


NA 


Change line number 




42F6 




from ($70) Bank 1 




SDB8 


NA 


Find RENUMBER start 




42FB 




from ($50) Bank 1 




S075 


NA 


Line count 




4300 




from ($61) Bank 1 




SD89 


MA 


RENUMBER increment S/R 




4305 




from (S24) Bank 




5D99 


NA 


Scan forwards 


CRUNCH 


430A 




Cruncti tokens ($AF8A) 




5DA7 


NA 


Btock move 


CRUNCH 


43QD 


A57C 


Crunch tokens (S0304) 




SDC6 


NA 


Move block down 


ESCLK 


4321 




Escape token crunch (S030C) 




SDDF 


NA 


Move block up 




43EZ 




Check il keyword found 


FOR 


5DF9 


A742 


Perform FOR 


RESIST 


4417 


A093 


Table ol Keywrords 




5e87 


NA 


Perform DELETE 


OPLIST 


46FD 


A140 


Ke/word vectors 




5EFB 


NA 


Get line range 


OPTAB 


4828 




Operator vectors ($AF6F} 




5F34 


NA 


Perform PUDEF 


ERRTAB 


484 B 


A19E 


Table ol error messages 




5F4D 


NA 


Perform TRAP 


ERROR 


4A82 


A437 


Find message (.A) slart ol error msg 




5F62 


NA 


Perform RESUME 


GONE 


4AA2 


A7E4 


Read and execute next slatemeni 




5FB7 


NA 


Reslore TRAP poinler 








($0308) 




5FD8 


NA 


Bad syntax — exit 


NEWSTT 


4AF6 




Set up statement for execution ($AF90) 




5FDB 


NA 


■■CAN'T RESUME" 


CONT 


4B34 
4a3F 


A857 
NA 


Update CONT pointer 
Execute/trace statement 




5FE0 


NA 


Perform DO 


ESCEX 


4aA9 




Skip statement ($0310) 




6039 


NA 


Perform EXIT 


STOP 


4BCB 


Aaac 


Perform STOP 




608A 


NA 


Perform LOOP 


END 


4BCD 


Ae2F 


Perform END 




60B4 


NA 


"LOOP NOT FOUND" 


GETFMN 


4BF7 


B3E1 


Set up FIsI reference 




60B7 


NA 


■■LOOP WITHOUT DO^' 
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CIRSUB 



FRMNUM 



FRMEVL 

EVAL 

EVAL1 

GIVAYF 

PARCHK 

CHKCOM 

SYNERR 

ISVAR 

MOVFRM 



DOREL 

NUMREL 

STREL 

NOTFNS 

NOTFDD 

BSERR 

UMULT 



FRE 
VAL 
VAL1 

PEEK 
POKE 



60E1 
61 OA 
61 AB 
62 B7 
642B 
653D 

eesE 

6750 
6797 
67D7 
6955 
6960 
69EZ 
6A5C 
6A79 
6B06 
6B17 
6B30 
6BSA 
6aC9 
6B07 
6C2D 
6C4F 
6CC6 
6DE1 
6Ea2 
6E82 
6EFD 
6FCI3 
6F1E 
6F69 
6F6C 
6F78 
6FD7 

7046 
70C1 
7164 
7190 
71 B6 
71 C5 
71 EC 
72CC 
7335 
7372 
76EC 
77B3 
77C4 
77D7 
77E7 
77EA 
77EF 
78D7 
78DA 
793C 
7950 
795C 
796C 
797B 
7A85 

7AAF 



7B3C 
7B46 
7CAB 
7D25 
7D2B 
7E3E 
7E71 

8000 
804A 
8052 
8076 
80C5 
B0E5 
80F5 
8139 
8142 
816B 
8132 
81 8C 
819a 
8203 
8240 
82AE 
B2FA 
831 E 
a37C 
8397 



NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 

NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
NA 
AD8A 



AE83 



AEF1 
AEFD 

AFoe 

AF2e 



B016 
601B 
B02E 
B11D 
B261 
B24S 

B34C 



B37D 
B7AD 

NA 

B80D 

B8Z4 

NA 

NA 

NA 

NA 

NA 

IMA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 



Oedne programmable key 

Pertorm KEY 

Pertorm PAINT 

Pertorm BOX 

Pertorm SSHAPE 

Pertorm GSHAPE 

Pertorm CIRCLE 

Draw circle ($AF78) 

Perform DRAW 

Pertorm CHAR 

Perform LOCATE 

Perform SCALE 

Perform COLOR 

Store current colours 

Perform SCNCLR 

Fill memory pajje 

Set screen colour 

Clear hi-ras screen 

Pertorm GRAPHIC 

Perform BANK 

Perform SLEEP 

Perform WAIT 

Perform SPRITE 

Pertorm MOVSPR 

Perform PLAY 

PLAY subroutine 

Set SID srjund 

PLAY error 

Dotted note 

Note A-G 

Sliarp 

Flat 

Rest 

Perform TEfyPO 

Pertorm FILTER 

Perform ENVELOPE 

Perform COLLISION 

Perform SPRCOLOR 

Perform WIDTH 

Perform VOL 

Perform SOUND 

Perform WINDOW 

Perform BOOT 

Perform SPRDEF 

Perform SPRSAV 

Pertorm FAST 

Pertorm SLOW 

Type match ctieck 

"TYPE MISMATCH fullSf^ATCH" 

"FORfi^ULA TOO COMPLEX" 

Evaluate expression (SAF96) 

Evaluate item ($AF93) 

Evaluate item (S030A) 

Coni/ert fixed-FLP ($AF03) 

Eval wiltiin parenltieses () 

Check lor comma 

Syntax error 

Search 1o( variable 

Unpack RAM to FLP Accum #1 

(SAF60) 

Locate variable 

Check variable 

Check it numeric 

Ctieck it string 

Cieate new variable 

Set up array 

"BAD SUBSCRIPT" 

"ILLEGAL QUANTITY" 

Calcuiale array size 

Array pointer S/H 

Perform FRE 

Pertorm VAL 

Convert ASCII string to FLP ($AF09) 

Pertorm DEC 

Pertorm PEEK 

Perform POKE 

Perform ERRS 

Swap X with Y 

Perform HEX$ 

Convert byte to hen 

Pertorm RGR 

Gel graphics mode 

Perform RCLR 

Pertorm JOY 

Perform POT 

Perform PEN 

Perform POINTER 

Perform RSPRITE 

Perform BUIJIP 

Periom RSPOS 





83E1 




8407 


RND 


8437 


HNDO 




QSETNR 




RND1 




RNDRNG 






84A7 


AYINT 


8484 


POS 


84C9 


ERRDIR 


84 09 




84DD 




84 EG 




B4E5 




84F5 


DEF 


84FA 


GETFNfVI 


8528 


FNDORE 


853B 


STRD 


eSAE 


CHRO 


85BF 


LEFD 


85 06 


RIGHTD 


860A 


MIDD 


8610 


PREAM 


8640 


LEN 


8668 


LEN1 


86 6E 


ASC 


B677 




8688 




a69A 


f^OVINS 


874E 


FRESTR 


877B 


FRETMS 


87E0 




87F1 




8803 


WAIT 




GETADR 


8815 


FSUB 


882E 


FSUBT 


8831 


FADD 


8845 


FADDT 


8848 




8917 




894E 


OVERR 


8950 


LOG 


89CA 




SAOE 


Ft^ULT 


BA24 


Ft^ULTT 


BA27 


ROMUPK 


aA89 


CONUPK 


8AB4 


MULDIV 


8AE3 


MUL10 


BB17 




8B33 


DIVIO 


8338 


FDIV 


8B49 


FDIVT 


8B4C 


MOVFM 


8804 


IW0V2F 


BBF9 


fvlOVIF 


8BFC 


MOVMF 


BCOO 


tulOVFA 


8C28 


MOVAF 


8C38 


ROUND 


8C47 


SIGN 


8C57 


SGN 


8C65 


ACTOFC 




INTOFC 




FLOATC 


8C75 


ABS 


eC84 


FCOMP 


8C87 


QINT 


6CC7 


INT 


8CFB 


FIN 


8D22 




AADD 


STCONS 






8DB0 


INPRT 


8E26 


LINPHT 


8E32 


FOUT 


8E42 


FOUTIM 




TICONS 




SQR 


BFB7 


FPWB 


8FBE 


NEGOT 




EXCONS 




FPWRT 


8FC1 


NEGOP 


8FFA 



NA 

NA 

E097 

E094 

EOBE 

E0D3 

EQE3 



B39E 
B3A6 



B3B3 
B3E1 
B3F4 
B465 
B6EC 
B700 
B72D 
B737 
8761 
B77C 
B782 
B78B 



B67A 
B6A3 
B6DB 



BB2D 
B7F7 
8853 

8867 
B86F 



B97e 
B9EA 
B849 

BA28 
BA30 
BA59 

BA8C 

BAB7 
BAE2 

BAFE 
BB07 
8812 
BBA2 

BB27 
BBCA 
BBDO 
BBFC 

BCOC 

BC13 
BC39 
BC39 
BC3C 
BC44 

BC58 
BC5B 

BC9B 
BCCC 
BCF3 

BD7E 
BDB3 

BDC2 

BDCD 

BDDD 

BE68 

BF11 

BF71 

BF7B 

BFB4 

BFBF 

BFB4 



Perform XOR 
Perform RWINDOW 
Perform RND 



Evaluate fixed number 

FLP-fixed signed (SAFOO) 

Perform POS 

Checti if direct mode 

"ILLEGAL DIRECT" 

"UNOEF D FUNCTION" 

Set up 16-bit tixed-FLP 

"DIRECT MODE ONLY" 

Perform DEF 

Check FN syntax 

Perform FN 

Perform STRS 

Perform CHRS 

Perform LER$ 

Perform RIGHTS 

Perform MIDS 

Se! up string parameters 

Perform LEN 

Exit from string mode 

Perform ASC 

Calculate string vector 

Set up string 

Move string to store 

Discard unwanted string 

Clean descriptor stack 

Get integer byte 

Get parameters for POKE WAIT 

Convert FLP to an address (SAFIX;) 

Perfom SUBTRACT ($AF12) 

Arg-FLP Accum #1 (SAF15) 

Add memory (SAFIB) 

PerfO'm ADDfSAFIBl 

Adjust FLP Accum #1 

Round up FLP Accum #1 

"OVERFLOW" 

Perform LOG (SAF2A} 

Add 0.5 

Muftiply by memory (SAF1E) 

Perform MULTIPLY (SAF21) 

Unpack ROM to FLP Accum #2 

ISAFSC) 

Unpack RAM to FLP Accum #2 

($AF5A| 

Adjust FLP Accum *1/«i2 

fvlultiply by 10 

"DIVISION BY ZERO' 

Divide by 1 

Divide into memory (SAF24) 

Pertorm DIVIDE (SAF27) 

Unpack ROM to FLP Accum #1 

(SAF63) 

Pack FLP Accum #1 to $5E 

Pack FLP Accum #1 to $59 

Pack FLP Accum (*1 to RAM (SAF66) 

FLP Accum #2 to FLP Accum *1 

($AF69| 

FLP Accum #1 to FLP Accum #2 

(SAF6C) 

Round FLP Accum #1 ($AF4B) 

Get sign (SAF51 1 

Perform SGN 



Convert fixed 10 FLP (SAFOF) 

Perform ABS ISAF4E) 

Compare FLP Accum #1 to memory 

(SAFS4) 

Convert FLP !o fixed 

Perform INT ($AF2D) 

Move string to FLP Accum #1 



est ASCII digit 

"IN" 

Print integer 

Convert FLP to ASCII ($AF06) 



Perform SQR (SAF30) 
Raise to power (SAF36) 



Perform exponent ($AF39) 

Perform MINUS/SUBTRACT (SAF33) 
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EXP 


9033 


BFED 


Perlorm EXP ($AF3C) 


POLYX 




E059 




RMULC 




E08D 




EADDC 




£092 




SAVET . 


9112 


E156 


Pertotm SAVE 


VERFr'T 


9129 


E165 


Perform VERIFY 


LOADT 


9130 


E168 


Perfoim LOAD 


OPENT 


9180 


ElBE 


Pertotm OPEN 


CLOSET 


919A 


E1C7 


Perfofm CLOSE 


SLPARA 


9299 


E1D4 


Sel aside room for siring 


COMBYT 




E200 


Check lor comma anfl gel byte 


CMMERR 




E20E 


Check (or last comma 


GARBA2 


92EA 




Garbage colleaion {SAFA2) 


COS 


9409 


E264 


Pertotm COS (SAF3F) 


SIN 


9410 


E26B 


Pertorm SIN ($AF42) 


TAN 


9459 


E2B4 


Perform TAN (SAF45) 


ATN 


94 B3 


E30E 


Pertorm ATN (SAF48) 




9520 


NA 


PRINT USING S/R 




99C1 


NA 


Perform INSTR 




9B0C 


NA 


Perform ROOT 


DRAWLN 


9B30 


NA 


Draw a line ($AF7e) 


QPLOT 


9BFB 


NA 


Plot a point (SAF75) 




9C70 


NA 


Set a hi-res colour cell 




9E2F 


NA 


Parse GRAPHIC command 




A07E 


NA 


Perform CATALOG/DIRECTORY 




Alio 


NA 


Perform DOPEN 




A134 


NA 


Perform APPEND 




A157 


NA 


Find next secondary address 




A16F 


NA 


Perform DCLOSE 




A18C 


NA 


Perform DSAVE 




A1A4 


NA 


Pertorm DVERIFY 




A1A7 


NA 


Perform DLOAD 




A1C8 


NA 


Perform BSAVE 




A218 


NA 


Perform BLOAD 




A267 


NA 


Perform HEADER 




A2A1 


NA 


Perform SCRATCH 




A2D7 


NA 


Perform RECORD 




A322 


NA 


Perform DCLEAR 




A32F 


NA 


Perform COLLECT 




A346 


NA 


Perform COPY 




A362 


NA 


Perform CONCAT 




A36E 


NA 


Perform RENAME 




A37C 


NA 


Perform BACKUP (joke) 




ASBF 


NA 


Parse DOS commands 




A5E7 


NA 


■■MISSING FILE f^jAfulE" 




A5EA 


NA 


■ILLEGAL DEVICE NUfitBER ' 




ASEO 


NA 


-STRING TOO LONG- 




A7E1 


NA 


"ARE YOU SURE?' 




A845 


NA 


Set Bank 15 




A84D 




IRQ S/R 


BASIC JUMP TABLE (C-12S only) 






AFOO 




JMP SS4B4. conven FLP to inlegw 




AF03 




JMP S793C: convert integer to FLP 




AF06 




JMP S8E42 conven FLP to ASCII 
strrng 




AF09 




JMP S8052. convert ASCII string to 

FLP 

JMP SeSlS convert FLP to an address 




AFOC 






AFOF 




JMP S8C75: convert address to FLP 


MATH FUNCTIONS (C-128 only) 






AF12 




JMP Se82E Mem-FLP Accum 




AF15 




JMP S8831 Arg-FLP Accum 




AFie 




JMP 58845 Mem + FLP Accum 




AFlB 




JMP S8848 Arg + FLP Accum 




AFlE 




JMP $8A24 fulem'FLP Accum 




AF21 




JMP S8A27 Arg-FLP Accum 




AF24 




JMP S8B49 Mem/FLP Accum 




AF27 




JMP S8B4C Arg/FLP Accum 




AF2A 




JMP IB9CA Log FLP Accum 




AF2D 




JMP SBCFB INT FLP Accum 




AF30 




JMP seFB7 SQR FLP Accum 




AF33 




JMP S8FFA Negate FLP Accum 




AF36 




JMP $8F8E Raise Arg to Mem power 




AF39 




JMP $8FC1 Raise Arg to FLPA power 




AF3C 




JMP $9033 Calc EXP of FLP Accum 




AF3F 




JMP $9409 Calc COS of FLP Accum 




AF42 




JMP $9410 Calc SIN of FLP Accum 




AF45 




JMP $9459 Calc TAN oi FLP Accum 




AF4B 




JMP 594B3 Calc ATN of FLP Accum 




AF4B 




JMP S8C47 Round FLP Accum 




AF4E 




JMP S8C34 ABS o( FLP Accum 




AF51 




JMP $6C57 Test sign of FLP Accum 




AF54 




JMP $BC87 Compare FLP Accum with 
Mem 




AF57 




JMP $8437 Make random FLP number 


MOVEMENT (C-1 28 only) 








AF5A 




JMP $BAB4 Move RAM Mem lo Am 



AF60 
AF63 

AF66 

AF69 
AF6C 

BASIC ROUTINES (C-tZB only) 

AF6F 
AF72 
AF75 
AF78 
AF7B 
AF7E 
AF81 
AF84 
AF87 
AF8A 
AFBD 
AF90 
AF93 
AF96 
AF99 
AF9C 
AF9F 
AFA2 
AFA5 



MONITR 

MONBRK 

MONCMD 



AF5D 



JMP $8A89 Move ROM Mem to Arg 



BOOO 
B003 
B006 
B050 
B08B 

Boac 

B0E3 

B11A 

B12A 

B1S2 

B194 

BIAB- 

B1D6 

B1DF 

B231 

B234 

32CE 

B337 

B3DB 

B406 

BS8B 

B599 

B504 

B659 

B7A5 

B7CE 

B8D2 

aBE9 

B901 

B950 

B9B1 

BA90 

EDITOR JUMP TABLE 

COOO 

C003 

C006 
C009 

COOC 
COOF 

C012 

C015 
C01B 

COIB 
C01E 
C021 

C024 
C027 
CD2A 

C02D 

CINT C07B 

CISC 

CI 70 

IRQ C194 

KBGET C234 



NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

t«JA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 

NA 



FF5B 



E518 



E5B4 



JMP $7A85 Move RAM Mem lo FLP 

Accum 

JMP $SBD4 Move ROM Mem to FLP 

Accum 

JMP $8000 Move FLP Accum to Mem 

JMP $eC2B Move Arg to FLP Accum 

JMP $aC36 Move FLP Accum lo Arg 



JMP $4828 Operator tables 
JMP $9B30 Draw a I ne 
JMP S9BFB Plot a point 
JMP S6750 Draw a circle 
JMP S5A9B RUN 
JMP SSI F3 RUNC 
JMP SSI F8 CLEAR 
JMP $5106 NEW 
JMP S4F4F LNKPRG 
JMP S430A CRUf^JCH 
JMP S5064 FNDLIN 
JMP S4AF6 NEWSTT 
JMP S78D7 EVAL 
JMP S77EF FRMEVL 
JMP S5AA6 NEWSn 
JMP SSA81 SETEXC 
JMP S50A0 LINGET 
JMP S92EA GAR BAG 
JMP S4DCD READY 

Perform MONITOR 

■'Break" entry ($0316) 

Command parser (S032E) 

R cmd registers 

Test command 

Error found 

X cmd: exit 

Read memory from Bank 

Write memory Irom Bank 

M cmd: memory 

; cmd- modify registers 

> cmd: modily memory 

G cmd: go 

J cmd: jump 

C cmd: compare 

T cmd: transfer 

H cmd: hunt 

LSV cmds: LOAD.SAVE.VERIFY' 

F cmd fill 

A cmd: assemble 

Test next opcode 

D cmd- disassemble 

Print instruction 

Classify opcode 

Input parameter 

Get value 

Convert byte to 2 ASCII cfiars 

Get character 

Copy addresses 

Incremeni pointer 

$ + &% cmd: conversions 

(at) cmd: wedge 



From SFFSt. JMP $C07B: init 

editor/screen 

JMP $CC34 show char in A. colour in 

.X 

JMP SC234. get key (IRQ) into A 

JMP SC29B: get char from screen into 

A 

JMP SC72D: pnnt char in A 

From SFFED JMP SCC5B get screen 

org in W.Y 

From $FF9F JMP SC55D scan 

keyboard 

JMP$C651: repeal ke/ 

From SFFFO: JMP SCC8A: readfset 

crsr in ,X/ Y 

JMP $CD57: move 8S63 cursor S/R 

JMP SC9C1: perform ESC (char in A) 

JMP SCCA2: redefine programmable 

key 

JMP IC194: IRQ entry 

JMP SCEOC: initialize 80 col chars 

JMP $CD2E 40/80 column location 

swap 

JMP SCAID: set window corners 

Initialize screen (SFF81,$C000) 

Sel UP new line 

80 column colour 

IRQ entry (SC024) 

Get a key (SC006) 
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KBINP 




E5CA 




SCNDK 


E4E0 


EDB9 


KSINP 




E632 




CIOUTK 


£503 


EODD 


SCINP 


C29B 


E63A 


Input Irom screen |SC009) 


UNTLKK 


E5t5 


EFEF 


TGLOT 


C2FF 


E6S4 


Check for quotes 








SCPUT 




E691 




UNLSNK 


ES26 


EDFE 


SCPNT 




E716 












C30C 




Wrap up screen pfint 


AOPTHK 




EE13 


IRQK 


C55D 


EAe7 


Scan keyboard (SC0 12) 


NMICNT 




EESB 


KEYVEC 


C5E1 




Keyboard read ($033A) 




E5C3 


NA 


REPEAT 


C651 




Get key and fepeal ($C015) 




E5D6 


NA 


KEYCHK 


C6A0 




Store key ($033C) 




E5F8 


NA 


KBDTBL 


CBAD 


EB81 


Keyboard decode tables 


f^SWRT 


E5FF 


EF06 


PRINT 


C7ZD 




Print to screen ($COOC) 


RSBLD 


Ee9D 


EF59 




C77D 


NA 


ESCO (escape) 




E795 


F04D 




C7B9 




Print CTRL character ($0334) 




E7CE 


F0B6 




CS05 




Print SHin character |S0336} 




E7EC 






C854 




CHR£(29): cursor right 




E805 






CB5A 




CHR$(17). cursor down 




E878 






CB80 




CHR$(14). text 




E8A9 






CeA6 




CHR$(11). lock 


THEADR 


EBDO 


F72C 




CSAC 




CHR$(12); unlock 




E919 


F76A 




ceB3 




CHR$(19): home 




Eseo 


F7D0 




VM'.? 




CHB$<18) rvs 




E987 


F7D7 




C8C7 


NA 


CHR$(2). underline on 




E99A 


F7EA 




CRCF 


NA 


CHR$(130): underline otf 




E9fi£ 


F80O 




0805 


NA 


CHH$(15); flash on 




E9Ce 


F8t7 




C3DC 


NA 


CHR$(143); (lash oft 




E9DF 


F82E 




C3E3 




Open screen line 




E9E9 






091 B 




CHR$(20): delete 




E9F2 


F841 




C94F 


NA 


CHR$<9): tab 




EA18 


F864 




0961 


NA 


CHR$(24): tab switch 




EAZ6 


FB75 




0980 


NA 


ESC Z clear all tabs 




EA8F 


F8D0 




0983 


NA 


ESC Y set delault tabs 




EAA1 


F8E2 




C98E 


NA 


CHH$(7): bell 




EAEB 






C9B1 




CHR$(10). Iineleed 




EC1F 




ESCAPE 


C9C1 


NA 


Test ESC sequence (SCO i £.30336) 




ED51 






CAM 


NA 


ESC T set window top 




ED5A 






CA16 


NA 


ESC B: set window bottom 




ED69 




WINDOW 


CAlB 


NA 


Set window (SC02D) 




ED8B 






CA3D 


NA 


ESC 1 insert line 




ED90 






CA52 


NA 


ESC D delete line 




EE2E 






CA76 


NA 


ESC 0: erase to line end 




EE9B 






CA8B 


NA 


ESC P, erase to line start 




EEAa 






OASF 


NA 


ESC (atl clear rest ol screen 




EEBO 






CASC 


NA 


ESC V scroll up 




EEDO 






CACA 


NA 


ESC W; scroll down 


NGETIN 


EEEB 


F13E 




CAE2 


NA 


ESC L scroll on 










CAE5 


NA 


ESC M scroll o« 


NBASIN 


EF06 


F157 




CAEA 


NA 


ESC C: cancel auto-inserl 










CAED 


NA 


ESC A- auto insert 




EF48 






CAF2 


NA 


ESC S block cursor 


f^BSOUT 


EF79 


PICA 




CAFE 


NA 


ESC U: underline cursor 










OBOB 


NA 


ESC E: non-fiashing cursor 


NOPEN 


EFBD 


F34A 




CB21 


NA 


ESC F Hashing cursof 










CB37 


NA 


ESC G: bell enable 










CB3A 


NA 


ESC H: bell disable 










CB3F 


NA 


ESC R: screen reverse 


NCHKIN 


FlOB 


F20E 




CB48 


NA 


ESC N screen normal 










CB52 


NA 


ESC K: go to end ol line 


NCKOUT 


F14C 


F250 




CBB1 


NA 


ESC J: go to star! ol line 










CC34 


E716 


Send character to screen ($C003) 


NCLOSE 


F1BB 


F291 


SCRORG 


CC5B 


E505 


Read row/column (SCOOF) 




F202 




PLOT 


CC6A 


esoA 


Read/set cursor (SC0 18) 




F212 




KEYSET 


CCA2 


NA 


Define function key (SC0211 


NCLALL 


F222 


F32F 


SWAPPO 


CD2E 


NA 


ESC X, switch 40/80 screen (SC02A) 








CURSOR 


CD57 
CDCA 


NA 
NA 


Positior 60-col cursor (SCOIB) 
Set Register 3i 


NCLRCH 


F226 


F333 




CDCC 


NA 


Set screen register 


CLHIO 


F23D 


NA 




CDD8 


NA 


Head Register 31 


LOADSP 


F265 


F49E 




CDDA 


NA 


Read screen register 










CDE6 


NA 


Set CRT to screen address 


LOAD 


F26C 


F4A5 




C0F9 


NA 


Set CRT !o colour address 




F27B 


F4BF 


INIT80 


CEOC 
EOOO 


NA 
Resei S/R 


Initialize 80 columns (SC027) 




F32A 
F3A1 
F4BA 


F539 


RESTOfl 


£056 


FD15 


From SFFSA reset standard I/O 
devices 




F4C5 
F503 




VECTOR 


E05B 


FD1A 


From SFF8D, set/store I/O vectors 




F50F 




RAMTAS 


E093 


FD50 


From SFF67 test RAfid 




F533 






EOCD 


NA 


Transfer all Banks 


SAVEP 


F53E 


F5DD 


lOINIT 


E109 


FDA3 


From SFF84: initialize I/O 










E1F0 


NA 


Search lor Boot ROfvt 


SAVE 


F54E 


F5F4 




E242 


NA 


Reset to 64/128 




F5B5 


F642 




E24g 


NA 


From SFF4D: G064 




F5BC 






E263 


NA 


Code to move to $02 




F5Ce 


F65F 


TALKK 


E33B 


ED09 


From SFFB4 send TALK on serial bus 


UDTIMK 


F5F8 


F69B 


LSTNK 


E33E 


EDOC 


From $FFB1: Send LISTEN on serial 


RDTIfi^K 


F65E 


F6DD 








bus 


SETfvIK 


F665 


F6E4 




E43E 


ED4Q 


From $FFA5; send byte on serial bus 


NSTOP 


F66E 


F6ED 




EDAD 




Error Device not present 




F67C 


F6FB 


TKSAK 


E4D2 


EDC7 


From $FF93: send secondary address 
ISA) 




F67F 
F682 


F6FE 
F701 



From SFF96 send SA alter LISTEN 

From SFFA8, output byte on serial bus 

From SFFAB, send Ut^iTALK on seriai 

bus 

From SFFAE. send UNLISTEN on 

serial bus 



Turn fast disk oft 
Turn fast disk on 
From $FF47: (lip last disk on/off 
Transmit RS232 
RS232 receive 
Set up BS232 inpul 
Get from RS232 
Interlock RS232/serial 
RS232 control I/O 
RS232 receive timing 
RS232 transmit timing 
Find any tape header 
Wnie tape header 
Gel buffer address 
Get SA. EA ol lape buffer 
Find specific header 
Advance tape bomter 
■■PRESS PLAY •■ 
Check tape state 
■■PRESS RECORD.. ■■ 
Initiate tape read 
Initiate tape write 
Tape code 
Check tape slop 
Set read timing 
Reao tape bils 
Store tape characters 
Reset pointer 
Nev/ character setup 
Send transition to tape 
Wnte data to tape 
Tape write 
Tape leader 
Switch IRQ vector 
IRQ vectors 
Tape motor off 
Control tape motor 

From SFFE4.S032A get a ctiar (usually 
keybd) 

From SFFCF.S0324. get a char from in- 
put oevice 
Get char from tape 
From SFFD2.S0325, send char 10 out- 
put oevice 

From SFFC0.S031A. open file (or 
read/write 



From $FFC6.$031E: prepare a file for 

input 

From SFFC9.S0320: prepare a file for 

output 

From SFFC3.S031C: close a lile 

Searcfi for file 

Set fJe parameters 

From SFFE7.S032C: abort I/O. dose 

files 

From SFFCC.S0322: restore default I/O 

devices 

From $FF4A: clear I/O 

From $FFD5; load memory Irom disk 

or lape 

Load (S0330) 

Seriai load 

Tape load 

Disk load 

Get serial byte 

Receive serial byte 

Toggle clock line 

■SEARCHING'^ 

■LOADING" 

From SFFD8: save memory to disk or 

tape 

Save (S0332) 

Terminate seriai input 

'SAVING^^ 
Save to tape 

From SFFE A: update clock ( + 1 ) 
From SFFDE; read Tl clock 
From SFFDB: set Tl clock 
From SFFE1.S0328: scan STOP key 
■TOO MANY FILES^' 
■•FILE OPEN" 

•FILE NOT OPEN" 
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F685 


F704 




F688 


F707 




F68B 


F70A 




F6BE 


F70D 




F691 


F710 




F694 


F713 




F71E 


F71F 




F722 




SETNAM 


F731 


FDF9 


SETLFS 


F733 


FEOO 




F73F 


NA 


READST 


F744 


FE07 


SETMSG 


F75C 


FE18 


MEMTOP 


F763 


FE2S 


MEMBOT 


F772 


FE34 


lOBASK 


F781 

F786 
F79D 
F7A5 
F7AE 
F7BC 
F7C9 


E5O0 




F700 


NA 




F7DA 


NA 




F7E3 


NA 




F7EC 


NA 




F800 


NA 




F85A 


NA 




Fa67 


NA 




Fago 


NA 




F9B3 


NA 




F9FB 


NA 


PRIMMS 


FA17 
FA40 
FA65 
FF05 
FF17 
FF33 


NA 



"FILE NOT FOUND" 
"DEVICE NOT PRESENT" 
"NOT INPUT FILE" 
"NOT OUTPUT FILE" 
"MISSING FfLE NAME" 
•ILLEGAL DEVICE NO" 
Print if direct 
Print I/O message 
From SFFBD: sel filename 
From SFFBA sel file*, device*, sec- 
adr 

From SFF68: sel loadteave Bank 
From $FFB7: read ST byle into .A 
From $FF90; error messages on/oft 
From $FF99 raad/set upper limit of 
BASIC 

From $FF9C read/sel lower limit of 
BASIC 

From $FFF3: get start of keyboard 
registers 

From SFF5C searcti for SA 
From SFF59 search/selup file 
From $FF50, trigger DMA 
Get cfiaracler from memory 
Store loaded byte 
Read byle to be saved 
From $FF74 get chat from Bank 
From $FF77: store char to Bank 
From SFF7A; compare ctiar wWh Bank 
From SFF6B: get memory control mask 
S/R to go to S02A2-$C2FB 
DMA cixfe to go to $03FO 
From $FF56 ctieck autostart ROM 
From IFF53: check for boot disk 
Read next boot sector 
Convert to 2 digit decimal 
From SFF7D: Print message 
Nfvll interrupt entry (S0318) 
Normal IRQ entry ($0314) 
NMI transfer entry 
IRQ transfer enlry 
Return from interrupt 



Kernal Table 



For space economy, this table g)ve« &128 vselors only. 





FF47 


NA 




FF4A 


NA 




FF4D 


NA 




FF50 


NA 


BTCALL 


FFS3 


NA 


PHENIX 


FF56 


NA 


LKUPLA 


FF59 


NA 


LKUPSA 


FF5C 


NA 


SWAPPER 


FFSF 


NA 


DLCHR 


FF62 


NA 


PFKEY 


FF65 


NA 


SETBNK 


FF6a 


NA 


GETCFG 


FF6B 


NA 


JSRFAR 


FF6E 


NA 


JMPFAR 


FF71 


NA 


INDFET 


FF74 


NA 


INDSTA 


FF77 


NA 


INDCMP 


FF7A 


NA 


PRIMM 


FF7D 


NA 


RELESE 


FF80 






FFB1 






FF64 






FFe7 






FF8A 






FF8D 






Frao 






Fl^ 






FF36 






FF99 






FF9C 






FF9F 






FFA2 






FFA5 






FFAS 






FFAB 






FFAE 






FFB1 






FFB4 






FFB7 





Fast disk toggle ($E5FB) 

Clear I/O (SF23D) 

G064 ($E24a) 

Trigger DMA ($F7A5) 

Bool load program from disk {SF890) 

Call card cold start rtnes (SF867) 

Searcti tables for LA ($F79D) 

Searcti tables for SA ($F7a6) 

Swap to alt display device ($C02A) 

Initialize 80 col character RAM (SC027) 

Program function key (SC021) 

Set Bank for LOAD/SAVEfl/ERIFY 

($F73F) 

Convert Bank to MMU specification 

($F7EC) 

JSR to any Bank, RTS to calling Bank 

($02CD) 

JMP 10 any Bank {S02E3) 

LDA |FETVEC),Y from any Bank 

(SF7D0) 

STA (STAVECJY to any Bank (SF7DA) 

CMP (CMPVEC).Y 10 any Bank (SF7E3) 

Print immediate ($FA1 7.atways JSR 

here) 

Release » of KERNAL ROf^ 

Iniiialire screen editor (SC(X)0) 

Initialize input/output ($E109) 

RAM test (SECI93) 

Reset vectors to default values (SE056) 

Change vectors lor user (SE05B) 

Control OS messages ($F75C) 

Send SA after LISTEN (SE4D2) 

Send SA after TALK (SE4E0) 

Set/read top of memory ($F763) 

Set/read bottom of memory |SF772) 

Scan keyboard (SC012) 

Not used in 01 28 

Handshake byte in ($E43E) 

Handshake byte out {$E503) 

Send UNTALK (SE515) 

Send UN LISTEN (SE526) 

Send LISTEN (SESaE) 

Send TALK (SE33a) 

Get I/O status ST (SF744) 



NMI 

RESET 

IRQ 



FFBA 

FFBD 

FFCO 

FFC3 

FFC6 

FFC9 

FFCC 

FFCF 

FFD2 

FFDS 

FFD8 

FFDB 

FFDE 

FFE1 

FFE4 

FFE7 

FFEA 

FFED 

FFFO 

FFF3 

FFFA 

FFFC 

FFFE 



Set LA FA SA (SF738) 

Set length. FN address (SF731) 

Open logical file (S031A.SEF6D) 

Oose logical file (S031C,$F188) 

Open channel in (S031E,SF106) 

Open channel out (S0320.SF14C) 

Close I/O channels (S0322.SF226) 

Input from channel (S0324.SEF06) 

Output to channel {S0326.$EF79) 

Load from Me (SF265) 

Save to file ($F53E) 

Sel internal clock {$F665) 

Read internal clock ($F65E) 

Scan STOP key (S0328,SF66E) 

Get char from queue ($032A.SEEEB) 

Close all files (S032C,SF222) 

Increment clock (SF6F8) 

Read screen size (SCOOF) 

Read/set X.Y on screen ($C018) 

Return I/O base ($F781) 

SFF05 = NMI 

SFF3D = resei 

SFF17 = IHQ 



Workspace In BANK 1 

BASIC 7.0 uses variable workspace in Bank 1 for its own re- 
quirements. A short list of recognized areas is given below. The 
list is not exhaustive, and care should be taken if you plan to 
use this space for your own programming. 



41B9 
4267 
46FC 
47D8 

S250 

SAFO 

6A4C 
6CB3 

6FE4 
6FE7 
6FEC 

702F 
7039 
7691 

8490 
849A 
8F76 
8F7B 
8F9F 

9005 
9485 
9CCA 
9D1C 

A627 
B6C3 
B71S 
B721 

0033 
C04C 
C065 
C06F 
C6DD 
C79A 
CEA8 

E073 
E105 
E2C7 
E2F3 

F50C 
FA80 

FAD9 
FB32 
FB8B 

FBE4 
FFOO 



Registers for SD501 
BASIC links 
Action vectors 
Function vectors 

PUDEF characters 
Keywords/RENUMBER 

Colour codes 
Bit masks 
Voice parameters 
Length characters 
Command characters 

Bell sequence 
SID voice steps 
Sprite vectors 

RND multiplier 

Value 32768 

+0.5 

Decimal constants 

Tl constants 

Exponent series 
Trigonometry series 
Video matrix lines hi 
Bit masks 

DOS command masks 

Mode tables for MONlTOfl 

Mode characters tor MONITOR 

Compacted mnemonics for MONITOR 

Screen address low 

Screen address high 

I/O link vectors 

Keyboard shift vectors 

Programmed keys 

Vectors 

Programmed key lengths 

Vectors to $03 1 4 
Bank transfer masks 
VIC 8564 setup 
CRT 8563 setup pairs 

"UO" disk reset 

Keyboard matrix unshified 

(S033E.S0346) 

Keyboard matrix shifted ($0340) 

Keyboard matrix C = key (S0342) 

Keyboard matrix CONTROL key 

(S0344) 

Keyboard matnx caps lock (S0348) 

MMU controls 
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NAME -^ 

STREET ADDRESS 
CITY/TOWN/P.O. 



PROV/STATE 
TELEPHONE 



iattwarm 
^-iorm 



POSTAtyZlP CODE 

MEMBERSHIP NO. 



TORONTO PET USERS GROUP, 101 Duncan MitI Road, Suite G7, Don Milfs, Ontario M3B 1Z3 416-445-4524 



To order dub disks dy mail, send Si 0,00 for each 

4040/2031/1540/1541 disk (4040 format), discount price 
S-10 S9.00 each, 11 or more sa.OO each; and S12.00 for 
each 8050/8250 disk |8050 format), \X/e do honour 
purchase orders from school boards. 




MsHs 



These disks are for use with a 
Please send me the following: 
3 Letter/No. 
Code 



computer and a . 



disk drive. 



Description 



4040 or 8050 
Format 



Price 



Totals 



.00 



tapes 




To order VIC 20 or Commodore 64 library 
tapes, send S6.00 for each tape. 
To order PET/CBM or Commodore Educa 
clonal Software, send SIO.OO for each tape. 



These tapes are for use with a 

If for a PET computer, what model - 

3 Letter/No. Code Description 



computer and a datasette. 

- BASIC - 1.0( ); 2.01 ); 4.0( )? 
Price 



Total S 



.00 



The prices indicated include postage and handling as well as 
Ontario Provincial Sales Tax (if applicable) 

D Cheque/money order enclosed (payable to TPUG) 



DVisa/Mastercard # 

Signature 




Library Additions. 



TPUG's library of public domain soft- 
ware grotvs month by month. Hundreds 
of disks containing thousands of pro- 
grams are available to TPUG members at 
the nominal cost often dollars per disk. 
Considering that each disk is packed with 
good programs, at today's software prices, 
this is a fantastic value. 

In order for the library to keep groiv- 
ing, our lihrariatis need a constant supply 
ofTietv programs. If you have written a 
program or a collection of programs that 
you think might be an asset to the librai'y, 
please send it to: TPUG Program 
Library, 101 Duncan Mill Road, Suite 
Gr, Don Mills, Ontario MsB IZS. 
Canada. If your contribution is accepted, 
you will be sent the library disk of your 
choice. If for some reason, your contribu- 
tion is not needed, your original disk unit 
be returned to you. 

On these pages our librarians describe 
recent additions to the library. 

VIC 20 Disk (V)TQ 
Presented by Richard Best 

The first disk/tape of 1986 starts out with 
a hectic game called Obliteration. This 
is a cross between Centipede and Space 

Invaders, in which you try to stay alive 
while continuously shooting at ap- 
proaching aliens. In Starbase, another 
space game, you protect your space sta- 
tion by firing rockets at the approaching 
asteroids. The popular game Berzerk has 
appeared on other VIC disks. This update 
is noisier, and also runs with a 
SuperExpander. 

Youngsters will find Timer/Add 
challenging — you have to solve as many 
addition problems as you can before the 
timer runs out. Cannibal is a simulation 
in which you set the ratio of cannibals to 
explorers. The explorers may not survive 
surrounded by hungry cannibals. Begin- 
ning programmers are not the only ones 
who will enjoy Dumb Prg, a clever demo 
of the CHR$() function. 

If you're anxious to press your VIC in- 
to service as a day planner, Chimes is just 
the thing. It allows you to set up to nine 
alarms, each with a message. Or how 
about a simple filing system? DBMS will 
store page after page of text and then 
save it all to tape . 

'Power users' will get a lot of use out 
of 5K Reset, 8K Off, and 8K On, which 
will help to clean up memory pointers, or 



enable and disable an 8K expander. And 
disk users have been screaming for Fast 
Format, a utility that formats a diskette 
in only 40 seconds. Once you've format- 
ted the disk, examine its surface vrith 
View BAM. 

The two remaining programs on this 
month's disk are truly unique. Men-Flex 
is a test for the cryptically inclined. It 
presents you with 20 number riddles 
derived from common phrases. Write 't- 
is a tool to be used by someone who is 
handicapped, and unable to communicate 
by norm means. It turns the VIC screen 
into a mi u of words and letters, and the 
joystick ^0 a pointer. Sentences can 
then be w tten on the screen by selec- 
ting their parts from the menu. 

Many thanks to all those who con- 
tributed programs throughout 1985. With 
your continued efforts we should be able 
to keep the VIC alive for at least as long 
as the venerable PET. D 



vie 20 disk Cv)tq 

11 "list-me Cv)t-q/r 
IB "list-me («)t-q/2" 
15 "oblit ins.wSk" 

IS "oblit ins.caas" 

15 "obliteration" 

fi "timer/add. v" 

8 "starbase ins.vSk" 

8 "starbase main" 

2 "5k reset. v5k" 

S "cannibal. w" 

12 "chimes. w" 

5 "dumb prg.tf" 
11 "wrlte+.w" 
25 "write+.seq" 
11 "berzerk.vSk" 
2 "8k off.tfl2k" 

1 "Bk on.tf12k" 

38 "men-flex. v12k" 

B "dbtns.v" 

B "fast format. tfSk" 

6 "view bam.vSk" 



prg 
prg 
prg 
prg 
prg 

prg 
prg 
prg 
prg 
prg 
prg 
prg 
prg 
seq 
prg 
prg 
prg 
prg 
prg 
prg 

pre 



Commodore 64 Disk (C)TQ 

Presented by Derick Campbell 

This month's C-64 disk has great pro- 
grams for everyone. 

Telecommunicators won't want to miss 
the latest version of Xmobuf , a terminal 
program that is great for using on Delphi, 
CompuS .'ve, and on TPUG's own 



bulletin board system (though you will not 
be able to use the program for uploading 
and downloading on the TPUG BBS). 

For programmers, we have the 
ultimate super-utility: a program with all 
the commands you'd ever want, and all 
in one package: the DOS Wedge, Tiny 
Aid, Super DOS, Xtramon, and many 
more. 

If it's educational computing that in- 
terests you, we have a computer quiz — 
just right for students; while for rest and 
recreation there are two games, and a 
song — Karma Chameleon. 

Who could ask for more? Don't miss it! 

n 

B c-64 disk (c) tq 



8 


"list-me Ccjtq" 


prg 


28 


"tank combat. c" 


prg 


1 


"pinball" 


prg 


160 


"pinball.pb" 


prg 


3 


"quiz. inst .c" 


prg 


57 


"quiz.c" 


prg 


18 


"prquiz.c" 


prg 


IB 


"super. aid. c" 


prg 


14 


"wedge. inst .d" 


prg 


14 


"tap. inst. d" 


prg 


21 


"super.doa.inst.d" 


prg 


42 


"s .a. comments. d" 


prg 


36 


"xman. inst .d" 


prg 


5 


"tap.9b5b-9fff .d" 


prg 


10 


"nGw.c780-cfff .d" 


prg 


12 


"xmon.74cc-B01b.d" 


prg 


9 


"culture club.c" 


prg 


36 


"chameleon. d" 


prg 


78 


"xmobuf 7.4" 


prg 


55 


"xmobuf.doc" 


seq 



C-128 Disk(Y)AA 

Presented by James Kokkinen 

This is the fir.st TPUG library disk for the 
C-128 computer. Due to the relative 
'newness' of this computer, submissions 
to the library are just beginning to drib- 
ble in, so there are some unused blocks 
at the end of this disk. All contributions 
to the C-128 library will be gratefully ac- 
cepted for review and possible inclusion 
in future monthly diskettes. 

What we do have this month is an ex- 
tensive demonstration of some of the 
features of the C-128 computer, as well 
as some communications terminal 
programs. 
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iLlbrary Additions 



Invention 13.mus is Commodore's 
demonstration of the C-128's SID chip 
playing two voices simultaneously. Sim- 
ple Key.mus and Music Board are short 
routines that allow users to create their 
own little tuiiea. Soundmaker allows easy 
creation of sounds that can be used in 
games, or as audible prompts in other 
programs. 

There are foiir communications pro- 
grams on this month's disk. Small- 
term. 128 is an X-Modem protocol ter- 
minal that, as well as CP/Term,128, can 
download to single-sided C-128 CP/M 
diskettes. The List Me (T)T1, as well as 
the sequential documentation files on this 
diskette, explain the above files in more 
detail, as well as Tacoterm.128, CP/M 
term2 and JHF Miniterm. 

In the recreational vein, there are two 
games included this month. Litter Patrol 
is a one-player game that has the partici- 
pant collecting garbage strewn over the 
highway by non-environmentally-minded 
automobile passengers. Deepsix.128 has 
the single participant diving for gems and 
dodging various underwater hazards. 
Both games are enjoyable examples of 
what one can create with the C-128's 
simplified graphics commands. 

Sprites on 128 is the text of Sean 
Rooney's well-received presentation to 
the February C-128 meeting. The balance 
of the sprite programs on this diskette 
were created and/or adapted by Sean for 
his presentation, and are included here 
for your enjoyment. 

The utilities included are mostly taken 
from the 1571 Demo Diskette, with a few 
exceptions, some of which are noted here. 
Uni-copy is Jim Butterfield's (it works in 
128 mode as well!). Keypad 64.C-128 is 
actually a C-64 program that permits the 
use of the C-128's keypad and cursor keys 
while in C-64 mode. 2 1571 keys allows 
the use of DOS commands for those for- 
tunate enough to own two 1571 disk 
drives. 

As noted by Bill Graves in the List Me 
program, several of these programs were 
downloaded from various bulletin board 
systems and, to the best of our 
knowledge, are all in the public domain. 

Editor's note: There will be no PET disk 
this month but Mike Donegan informs us 
that there will be an Amiga disk by the 
time you read this. D 



B c- 


-128 dis 


k Cy)aa 




17 


"list 


me Ct)tr 


prg 


1 


wt 


.music " 


prg 


7 


"inven 


tion IS.mus" 


3 


"simpl 


e Key.mus" 


prg 


3 


"music 


board" 


prg 



2 


"soundmaker" 


prg 


3 


"car race" 


prg 


1 


". .communications" 


prg 


1 


"...utilities..." 


prg 


37 


"smallterm.12B" 


prg 


14 


"uni-copy" 


prg 


51 


"cp/m term. 128" 


prg 


8 


"dir print" 


prg 


16 


"cp/mterm.doc" 


seq 


9 


"dir squeeze" 


prg 


69 


"tacoterm. 128" 


prg 


14 


"disk-dump" 


prg 


18 


"cp/m term2" 


prg 


6 


"display bam" 


prg 


5 


"jhf miniterm" 


prg 


6 


"change unit" 


prg 


13 


"Jhf miniterm doc" 


seq 


8 


"unscratch" 


prg 


1 


". .games/demos . . ." 


prg 


8 


"load address" 


prg 


13 


"litter patrol" 


prg 


5 


"seq lister" 


prg 


14 


"deepaix.iaa" 


prg 


S 


"header change" 


prg 


IB 


"sprites on 128" 


seq 


9 


"printer test" 


prg 


7 


"sprsav demo" 


prg 


4 


"format disk" 


prg 


3 


"bent space" 


prg 


8 


"autoboot maker" 


prg 


2 


"black hole" 


prg 


4 


"keypad 64.c128" 


prg 


3 


"wavy spokes" 


prg 


2 


"2 1571 keys" 


prg 



We'll Send You Money! 



Thafs right — TPUG Inc. will send you — with NO 
obligation (on our part) — hard cash that you can spend 
as you please. You don't even have to be a TPUG member! 
Hard to believe? It's true! 

Here's how to take advantage of this special offer: 
Just send us a self-addressed stamped envelope, along 
with an original unpublished article suitable for TPUG 
Magazine. The topic doesn't matter — just make sure that 
it relates to Commodore computers, and that it's brilliant. 
We do the rest. 

Your article should be on a Commodore disk, preferably 
with accompanying hard copy. Sequential PET ASCII files 
are best, with no embedded word processor commands, 
but other formats are acceptable. Just be sure to state both 
disk format and word processor used on the label of the 
disk, along with your name and the filename of the article. 
We'll get back to you as soon as possible, usually within 
three weeks of receiving your submission. 

By the way, if you have an idea for an article, but you're 
not sure whether it's suitable for TPUG Magazine, check it 
out with us first. Just call (416) 445-4524 (9 to 5 EST 
weekdays), or drop us a line at: Submissions Department, 
TPUG Magazine, 101 Duncan Mill Road, Suite G-7, Don 
Mills, Ontario, Canada M3B 1Z3. 



And remember, if we print your article 
money! 



we'll send you 
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Micro Processes. 



Amiga/C-64 
File Transfers 



by Chris Johnson 

I am writing this article with Ed, the full-screen editor that 
comes as part of AmigaDOS. When I write an article for TPUG 
Magazine, I usually send it by modem. Unfortunately, I have 
neither a modem nor a terminal program for the Amiga; I do 
have a Commodore 1650 modem and several terminal programs 
for my C-64. 

1 also have a null-modem cable that I use to connect jLhe two 
computers (with a VIC-lOllA interface on the C-64); ^nd the 
,\migaDOS has commands that enable the transfer of material. 
{These would work just as well if there was a modem connected.) 

On the C-64 I load a terminal program with a buffer. I am 
using FirstTerm, which is available on a TPUG disk. I open the 
buffer with togo-b. 1 am using the default communications speed 
of 300 BIPS, though I could increase it to 1200 BIPS. (The C-64 
does not receive reliably at higher speeds than that, though I 
regularly send material from a C-64 to another computer at 2400 
BIPS.) 

On the Amiga, I have used Preferences to set the baud rate 
at 300. 1 open a CLI window and enter the following command: 
type < filename > to ser:. This command will be familiar to 
users of CP/M or MS-DOS, but new to most Commodore users. 
If I had left off the to ser:, the file would have been printed 
on the screen. As it is, the file is sent to the serial port, through 
the null-modem cable, and into the buffer of my C-64. When the 
file is received, I leave terminal mode on the C-64, save the buf- 
fer to disk, and ship it later to TPUG Magazine by modem. 
The same command can be used to receive files from another 
computer. This time, the command is; 

TYPE SER: to dfO:< filename > 

This takes the bytes coming in through the serial port and stores 
them in the specified file. To exit and close the file, type CTRL- 
C on the Amiga; this will not take effect until the incoming buf- 
fer is full , so transmit a string of characters (spaces will do) from 
the other computer until the * *BRE AK appears on the Amiga. 

There is one small problem, however, with sending Ed files 
from the Amiga, which is that Ed stores data line by line, with 
a linefeed character (chr$(1 0)) at the end of each line. Most word 
processors on Commodore computers use the carriage return 
character (chr$(13)) as the terminator, and then only at the end 
of each paragraph, not each line. 

But it is not hard to write a program to strip the unwanted 
linefeeds from the file. The only requirement, when preparing 
the Ed file, is that a 'hard' line ending — one that will not be 
translated to a space when the file is formatted for printing or 
typesetting — must be entered with two carriage returns. This 
is normally done at the end of a paragraph, for instance, and 
at the end of each line of such data as program listings. 

The stripping of the unwanted characters can be done at either 



end. I use the following ABasiC program on the Amiga to send 

the files and strip the line endings at the same time. 

10 cnl$ = chrS(155) + "E" 

20 unS = chrS(IO) 

30 headers = homeS + cnl$ + "Transmit file to serial port." 

+ cnIS + chrS(IO) + string$(37,"=:") 

40 print headerS; cnl$ 

50 input "Filename"; filenames 

60 on error goto 180 

70 open "i", #1, filenames 

80 open "o", #2, "ser:" 

90 while not eof(t) 

100 line input #1, aS 

110 if lastllne% and len(aS) then print #2, " "; 

120 print #2, aS; 

130 if len(aS) = then print #2, chrS(13); chr$(13); 

140 lastline% = len(a$) 

150 wend 

160 close 

170 end 

180 print err$(err); cnIS 

190 print "Press any key to continue." 

200 getkey i$: scnclr: resume 40 D 



Formatting MFM Disks 
on the 1571 Disk Drive 



by M. Garamszeghy 

Copyright ® 1986 M. Garwmszegky 

The 1571 disk drive is capable of reading and vsrriting a number 
of standard CP/M disk formats when used with a C-128 in CP/M 
mode, including (among others): 

• IBM CP/M-86 single-sided 

• IBM CP/M-86 double-sided 

• Kaypro II single-sided 

• Kaypro IV double -sided 

• Osborne single-sided 

• Epson QX-10 double-sided 

• Sheer 9 

These are all referred to as MFM (maximum frequency modula- 
tion) formats, based on the technique used to record the data 
on the disk. Normal Commodore DOS (used by the 1541, for 
example) uses a method called GCR (group coded recording), 
which is totally different from MFM. There are several other 
differences between MFM and GCR disks. MFM disks gener- 
ally have the same number of sectors on each track, while Com- 
modore GCR disks usually have different numbers of sectors 
for different ranges of track numbers. MFM tracks are 
numbered from zero, while the sectors on each track are 
numbered from one. This is the opposite of Commodore GCR 
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disks, where tracks are numbered from one and sectors start 
at zero. 

Although Commodore CP/M can read and write in MFM for- 
mats with a 1571 drive, the current version of the format.com 
program supplied on the CP/M system disk cannot create or for- 
mat new disks in these extended disk formats. It is, however, 
quite simple to format disks in these or any other format you 
wish with a 1571 drive. 

In addition to the standard Commodore DOS commands, the 
1571 has a few new ones. These commands, collectively defined- 
as 'burst mode' in the 1571 manual, allow you to read, write 
and format disks in virtually any format you choose. Most of 
the commands, such as those for reading from and writing to 
the disk, need fairly sophisticated machine language program- 
ming to access, because the required high-speed data transfer 
is under totally manual control. The extended format command 
is the simplest to use. It can be quite easily invoked from BASIC 
because high-speed data transmission is not required. 

The description of the burst mode commands in the 1571 
manual is cryptic at best. The syntax for the MFM format com- 
mand can be simplified to: 

open1S,8,15,"uB"+chr$Cb1)+chr$[129)+chr»[0 
) +chr$( b4) +Ghr$( 39) +Ghr$t b6) : dclose 

In this instruction, bl must be set to 70 for a single-sided disk, 
or 102 for a double-sided disk; b4 is a number from to 3, 
representing 128, 256, 512 and 1024 bytes per sector respect- 
vely; and b6 is the number of sectors per track. 

The actual bit patterns in the characters sent after the UO 
(which selects the burst mode) are explained in detail in the 1571 
manual. I have simplified them here to make the command easier 
to use. There are other optional parameters that allow you to 
partially format a disk, format different areas of the disk in a 
different manner, change the sector slew rate, change the fill 
byte, and so on. These can be the basis of, for example, a sim- 
ple yet very effective copy protection scheme that you can use 
on your own disks and programs. Try reformatting track 35 on 
a standard 1541 DOS disk with the instruction: 

Qpenl5,8,15,"u0"+chr$( 198) -i-chrSC 129} +chr$( 
0) +chr$( 0) +chr$C 3S) +chr$t 10) +chr$( 34) +ch 
r${34) :dclase 

Now see what happens when you try to copy the disk, even with 
a whole-disk nibble-type copier for protected disks. If the pro- 
gram you wish to protect tries a random access block-read or 
block-write to the reformatted track, an error will result. If the 
drive (either a 1541 or 1571) does not return an appropriate read 
error code, the disk has been formatted in GCR and is obvious- 
ly not an original. The reformatting of track 35 should be done 
before you copy your program to the disk, in order to ensure 
that no program data are lost by wiping out the track. In addi- 
tion, you should use the DOS block-allocate command to 
allocate all sectors on the track, to prevent DOS from acciden- 
tally trying to write there. 

The following short BASIC 7.0 program, MFMFonnat, is for 
use in the C-128 native mode. It allows you to effortlessly for- 
mat disks in a number of different MFM formats on the 1571 
drive. The DATA statements at the end of the program contain 
the required parameters (sectors per track, bytes per sector and 
number of sides) for each type of disk. These parameters can 
all be changed to create custom disk formats if you wish. 
However, most of the possible formats will not be supported 
by CP/M on the C-128, In addition, the line numbers for the 
DATA statements should not be changed, due to the use of a 
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calculated line number reference in line 30 for reading the 

selected data. 

10 print" fflfm disk formatter" :pri 

nt" by m. garamazeghy" 
20 print" options: " :fQri=lto5:readfl,a,a,a 

$:printi": ";a$:next 
30 input" select a format";f :restore( f*10 

-H00):read b6,bs,sd,f$ 
40 print" format >> ";fS:print" press <r 

eturn> to continue" 
50 print" or press any other key to abort" 

igetkeyaj: ifa$<>chr${ 13) thenrun 
60 bS=39:s(0)-128:s( 1) =256 : s( 2) =512: sC 3) =1 

024:si^0:ifad=2thensi=32 
70 bl=7BQrsi:fori=0tQ3:ifbs=s(i)thenb4=i:e 

]^ senEX t 
80 openlB.a, 15, "u0"+chr$( bl) +chr$( 129)+chr 

$[ 0] -^ch^$[ b43 +chr$[ 39) +chr$( b6] 
90 input#15,a:dclose:input" format anothe 

r <y/n>";fa$:iffa$="y"then40 
100 dataB,512, 1 ,"ibm cp/m-86 single-sided 
110 data8,512,2,"ibm cp/m-Sfi double-sided 
120 ddta10,512,2,"kaypro iw double-sided 
130 data10,S12, 1,"kaypro ii single-sided 
140 dataS, 1024, 1,"osborne single-sided 



A Secret in a 
DRAW Command 



by Elizabeth Deal 

There is an undocumented polar -coordinate drawing command 
in the B ASICs for the newer Commodore machines, the Pius/4, 
the C-16 and the C-128. If you disassemble Plus/4 ROMs, you 
will see that the DRAW command begins at $C4D9, It uses 
several subroutines, of which one - at $C3F7 — is of interest: 
it fans out to do various kinds of jobs depending on which of 
many permitted syntaxes are in the program. The system tries 
to get X and Y coordinates but, if it finds them separated by 
a semicolon (the test for this is at $C400-C405), what would be 
X is taken to mean radius length, and what would be Y is taken 
to mean an angle (North is degrees, East is 90, and so on. 
Notice I said 'degrees' — not 'radians'!), A value over 360 
degrees wraps around back to zero, but there is a two-byte limit 
on its size. 

The variety of permitted syntaxes seems almost unlimited. 
The following two programs will allow you to study this useful 
variant of the DRAW command in more detail. 

In the Rays program, line 150 just plots a point 25 pixels away 
from the center, placed at x =y = 100, at an angle \'arying with 
J, which in this case is 12 points on a circle, every 30 degrees 
(like the hour markers on the clock). If you add, one by one, the 
remaining lines (listed here with REM in front of the code) you 
should be able to see how DRAW behaves. 

Pressing any key cancels the graphic mode, so you can play 
with the program. 

In the "Tiny Turtle program, the drawing angle is a sum of 
previously used angles, so that you can draw in the same fashion 
as in the LOGO language. 'Distance' is LOGO'S forward com- 
mand, and 'angle' is LOGO'S turn command. A bunch of 



March 1986 33 



Micro Processes 

60-degree turns with the same distance value will close up a 
hexagon. 

I am not testing DA for a 360-degree limit; you may wish to 
do that. To get out of the input loop, just enter negative values. 
SCALE 1 allows fairly large values to be used — see your manual 
for details. 

100 rem rays 

120 scale 0:graphic 1,1 

130 n = 12:a = 360/n 

140 for j=:0 to n:da = j*a 

150 draw 1,100,100,25;da 

160 rem draw 1 to 35;da 

170 rem draw to 4;da 

180 rem draw 1 to 10;da 

190 next j 

200 get key i$:graphic 

100 rem tiny turtle path 

110 scale 1:graphlc 2,1 

120 locate 100,100:da = 

130 inpuf'dlstance, angle";d,a 

140 if d<0 or a<0 then graphic 0:end 

150 da = data ''■ 

160 draw 1 to d;da "" 

170 goto 130 

A project: A spiral is a straight line in the polar coordinate 
system. Try writing a tiny routine to draw at least five swings 

of a spiral. D 



Printing Graphs 

from the 

Home Accountant 



by Karl Thurber 

As furnished by Continental Software, the popular Home 
Accountant program for the Commodore 64 can generate and 
save a variety of graphs to disk, but you're on your own in figur- 
ing how to print out those saved graphs — at least in Version 
"E" of the program (which I have), and previous versions. Here's 
one way to print out those fancy household graphs, if you have 
a printer utility program such as is contained on the Cardco 
Printer Utility Disk: 

• Generate the desired graph and SAVE it to disk, using the 
GRAPHS option of the Home Accountant MAIN MENU. 

• Using the Cardco disk, load the Printer Utility program and 
select the Keyed Screen Dump option from the menu. Choose 
a memory location from the menu for the dump (Choice 1 , $C800, 
works well). Indicate your type of printer (I use a Gemini lOX), 
and indicate whether you want a single or double density print- 
out (the former is easier on the ribbon). When the READY 
prompt appears , type in the required SYS command . Now , you 
are ready to dump a screen by hitting the Fl function key on 
your keyboard. 

• Now, load the Home Accountant GRAPH module. Note that 
this is an entirely separate program on your disk from the main 



set of Home Accountant programs, and is not the GRAPH op- 
tion accessed from the MAIN MENU. Use this program to LOAD 
in your saved graph. 

• When your saved graph finishes painting itself on the screen, 
and the disk drive light goes out, hit the Fl key. Your graph 
should be dumped to your printer. 

The graphs that result are somewhat elongated from how they 
appear on the screen, but nevertheless look quite professional. 
Other screen dump utility programs can be used, but the Card- 
co program is inexpensive and simple to use, and it .. "videly 
available. 

If you have trouble with the printouts, experiment with the 
DIP switch settings on your interface and/or printer, or with 
the memory location you selected for the screen dump routine 
from the Cardco Printer Utility program (four default locations 
are available). I found that my lOX gave good results with my 
Tymac Connection printer interface set to the 'transparent' 
mode with line feeds on. D 



Organize Your 
Disk Directories 



by Karl Thurber 

How often have you forgotten which directory entries belong 
with which set of programs? Which program is the one to load? 
Which program is the instruction file? 

If you work with programs that involve several sub -programs 
or files, it's well worth your trouble to organize their placement 
on the disk. A typical scenario would be to have an "empty" 

filename that shows what follows, such as *' Blaster Game". 

The first file should be the one you load, and may be called the 
program's name, or perhaps "Boot". The main program files, 
loaded by the boot (if any is required), may be indented or other- 
wise labeled so that you don't try to load them directly. After 
the last sub-program directory entry, either enter a blank line, 

" " , or start another empty filename for the next 

series of programs on the disk. 

Leave room at the top of the list for a menu, DOS wedge, or 
your favourite utility. For example, if your first entry is a menu 
for the whole disk, you can 'autorun' it by typing LOAD "*",8:, 
then hitting SHIFT/RUN-STOP. This adds a professional touch 
to your programming, 

A word of caution: when repeatedly scratching and re-saving 
programs, you may find that your 154rs DOS has moved the 
relative position of your files within the directory . Thus on first 
inspection, your files may have apparently 'disappeared'. You 
can reorganize the disk if this happens, using the Copy command 
of the DOS Wedge; better yet (at least less confusing), use a 
file-by-file copier to transfer the files to a new disk. This will 
also let you reorganize the order of the files on the disk. 

Also, don't run your directory listings through a program that 
alphabetizes your entries if you follow this technique! Your direc- 
tory entries will then be in alphabetical order, but you want them 
in program order! D 
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Inexpensive 
Disk Drive Fans 



a plastic or metal grill when you buy your fan, if avail ble, to 
prevent finger-damage! Finally, install four small rubber moun- 
ting feet (the sticky -back kind is best) on the fan to keep it from 
marring the top of your disk drive when it rests on the drive. 
Arrange the airflow to blow in or out — it's your choice! 



by Karl Thurber 

Would you like to cool your disk drive for under $10? For over 
a year I have cooled my 1541s with 'new surplus' muffin fans. 
Flat and square-shaped, muffin fans are used to reduce the in- 
ternal temperature of much electronic equipment — just what's 
needed to make a 1541 run cool. 

Muffin fans are often sold used for $4-6 and as new surplus 
for $7-9 through electronics parts houses and surplus vendors, 
who advertise in the pages of such electronics publications as 
Radio-Electronws. Many of the amateur radio publications, such 
as 73, QST, CQ and Ham Radio, also carry ads from such sup- 
pliers. Look for the magazines, and send for the catalogs of ap- 
propriate vendors. The fans are in plentiful supply ; you just need 
to find out which firms stock them. 

Even better, attend a local 'hamfest' or 'flea market' at which 
used and surplus electronic equipment is sold. Almost always, 
there are dealers and individuals in attendance who sell such 
fans. Consult the magazines listed above for news about these 
events, or, if you know a local ham radio operator, ask him when 
the next harnfest is scheduled in your area. 

Some cautions: be sure you obtain a 110-130 VAC 50/60 cy- 
cle fan (other fans look the same); and try to obtain the special 
little connector plug that mates with the one on the fan. Obtain 



Saving Efisk E&rectDiies 



by Karl Thurber 

If you don't own a printer, but would like to have a record of 
early versions of a particular disk's directory, you can actually 
load in the directory and immediately save it to disk, where it 
is stored just Hke any BASIC program. 

For example, if you have a particular disk that you're about 
to rearrange, and would like to be able to recall the particular 
programs that were on it, and their order in the directory, before 
working on the disk, do this: LOAD "$",8 to bring the disk's 
directory into the computer's memory. Add any comments you'd 
like to have saved, such as the date (don't worry much about 
syntax, since this is a non-runnable program). Save what you 
have to another disk, giving the saved directory a convenient 
filename. The saved directory may be recalled at a future date , 
should you wish to know what the directory looked like at a cer- 
tain time. 

In experimenting with this procedure, I found that I could not 
save the directory under the reserved filename "$". However, 
"DIRECTORY" or "CATALOG", or filenames with these words 
in them, would work okay. □ 



OS/9 Software 

NOW AVAILABLE! 



Word Processor - 
Stylograph III 

Mail merge, Spell checker. Menu driven, 
fast. Extensive features. Formats to screen 
as you work US $149 Cdn $210 

C Compiler 

A full implementation of K & R standard C, 
with double precision variables. 
US $138 Cdn $170 

BASIC09 

A fully structured, sophisticated semi- 
compiled (I code) BASIC. See Byte 
magazine April 1984. . US $110 Cdn $155 



FORTRAN 77 

Full FORTRAN compiler, . .coming soon. 
US $120 Cdn $166 

DynaStar, DynaForm, 
DynaSpeii 

A full screen (similar to microEDIT) editor, 
text formatter and spell checker. 
US $90 Cdn $127 

Other; Pascal, DynaCalc, Database etc., available on 

demand. 

To Order: Send a cheque or money order {add S 10 for 
shipping/handling and 7% PST where applicable) to: 
TPUG, 

101 Duncan Mill Rd., Suite G-7, 
Don Mills, Ontario, Canada MSB 1Z3 
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Movie Maker 

from Electronic Arts 
Animation program 
for Commodore 64 



Review by Mike Martin 

Electronic Arts has just rereleased a pro- 
gram called Movie Maker. This anima- 
tion program came out several years ago, 
at much higher cost — almost double that 
of this version. The new incarnation in- 
cludes more material, in the form of some 
animation by the bizarre cartoonist 
Gahan Wilson, 

Movie Maker comes on two double- 
sided disks with a manual written for 
Commodore, Apple, and Atari versions. 
The manual begins with a tour of the 
'studio' and descriptions of production 
terms and commands. At first glance, the 
program seems very complicated, but 
each section involves just a few com- 
mands, and is easily mastered. 

The program allows the creation of 
'movies' with fairly detailed animation, 
but with many restrictions. Three hun- 
dred 'frames' of animation are permitted. 
Standard theatrical movies run at 24 
frames, or individual pictures per second. 
At that rate, these 'movies' would be lit- 
tle longer than 13 seconds. Movie Maker 
permits the selection of nine speeds, so 
the production can run longer, depending 
on the detail desired. Each film consists 
of up to six video tracks, with a maximum 
of 16 sequences of animation, and three 
sound tracks. 

You start by making your drawings, in 
the Composing Room. You have two 
screens resident. One is the Background; 
the other contains all the drawings you 
plan to use. You are permitted four, and 
only four colours. This is limiting, as the 
same four colours (including the 
background) must be used all the way 
through. You may choose from all the 
usual 16 colours. If you draw a blue sky, 
and green grass, you then have two col- 
ours left for people or buildings. The 
graphics editor is limited and slow. After 
drawing your first figure, you 'outline' it, 
or define it so the computer knows where 
it is. You then duplicate it right next to 



the first drawing, and change the position 
of an arm or leg. The process continues 
until you have all the positions you need. 
The editor allows change of pen colour, 
fill, erase, duplicate, and mirror, but not 
'plot' or 'shapes'. By loading an 'Xtra 
Function File', you may add text or 
change the scale (size) of a drawing or 
text. While drawing is difficult, most 
figures only require three or four posi- 
tions to animate walking or other 
movements. The figures are on the rough 
side. 

After completing the dravrings, you 
then define the sequences. For my first 
project, I drew a monitor with 'TPUG' in 
large letters, and 'READY' in small let- 
ters with a flashing cursor. The cursor 
turns into a butterfly and flutters off the 
screen. My first sequence was composed 
of a small square alternating with a blank 
frame. I set the speed at four, and let it 
cycle between those two drawings. I 
followed this with a four-frame sequence 
of the butterly transformation, followed 
by a four -frame sequence of the wings ful- 
ly extended, then half-folded, and fully- 
folded, then back to half-folded. This se- 
quence cycled over and over. After posi- 
tioning the 'cursor', I recorded a few- 
seconds of it flashing. Then when the 
transformation sequence finished, I used 
the joystick to define the movement of 
the butterfly around the screen. One com- 
mand allows the choice of how many pix- 
els each figure moves at a time. 

After recording the animation music, 
an 'Xtra' file is loaded for sound. One file 
is just sound effects. Number keys 1 
through 9 are used to call up individual 
effects, and silences them. The other 
'Xtra' file is for music, but has only nine 
notes, with no provisions for volume, or 
defining the notes in any way. 'Limited' 
may be too kind a word for the musical 
capabilities of Movie Maker. 

With the background, shape, anima- 
tion, and sound files in memory, you can 
choose the smooth function, which con- 
verts the files into a completed produc- 
tion, It evens out the animation, and 
creates a final file. The smooth function 
permits the addition of credits at the head 
and tail of your feature. They scroll neatly 

by. 

Text may also be used as a sequence 
within the film, and manipulated on 
screen along with your drawings. 

Several files can be transferred to your 



data disk to run your movie without 
Movie Maker loaded into your computer. 
These files include a number countdown, 
and several frames of credits for the com- 
pany that made the program. 

The manual presents several ideas for 
the use of your movies, but the best one 
involves making titles and credits for 
your videotapes. Also suggested is the 
creation of animated 'greeting cards' for 
your friends. The program is fun to use, 
and will provide hours of entertainment 
for children. (My 'Butterfly' classic took 
three hours to complete.) It might even 
inspire a few new-generation Walt 
Disneys. It won't, however, put the 
National Film Board out of business. D 



Printer Book For 
The Commodore 64 

by R. Bruckmann, 

K. Gertts and T. Wiens 

Abacus Software, 1 984 

350 pages. $19.95 (US) 



Review by Ranjan Bose 

I have a 1526 printer, and after buying 

this book my first reaction was — why did 
I bother? It contains only a few pages 
about my printer, and not all the infor- 
mation is accurate. Having purchased the 
book, though, I read it anyway, and 
discovered that it is, all told, a fairly good 
source of general information about dif- 
ferent printers and interfaces. It also 
shows how to hook up an electronic 
tj-pe writer to your 64. 

The 1525/MPS 801 printers and the 
1520 plotter get the lion's share of the at- 
tention. For owners of the latter machine, 
this book is the only source of vital infor- 
mation and utihty programs that I know 
of. Useful hardcopy and high resolution 
screen dump routines for several printers 
are provided (including the odd 1526). A 
useful routine for printing formatted- 
tabular printouts is there as well, A com- 
plete description and memory map of the 
MPS-801 operating system is included. 
The optional accompanying disk ($14.95 
US) has all the programs and subroutines 
from the book and is a worthwhile 
purchase, □ 
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Print Jlaster 
jHikE IHartin 




Review by Mike Martin 

As I moved towards the back of the store, 
it caught my eye. I approached cautious- 
ly, and glanced at the box out of the cor- 
ner of my eye. I picked it up, sniffed, and 
then shook it. After reading the box five 
or ten times more, I bought it. 

After all, Print Shop by Broderbund 
was my first love. It has faithfully served 
me for over a year, and even provided 
more disks of graphics, with the promise 
of a companion disk of more borders, 
fonts, and a graphics editor with class. 
Could I be unfaithful to Print Shop after 
all this? 

The similarities between the two 
packages are striking. Print Shop was 
first released for the Apple computers, 
then translated for Commodore, Atari, 
and finally IBM, Print Master by Unison 
World was written for the IBM, then 
translated for Commodore, Epson, and 
a CP/M version for Kay pro and com- 
patibles. Print Master appears to be 
heavily inspired by Print Shop. I wasn't 
expecting much other than a slightly dif- 
ferent version of Fh-int Shop. But its pale 
yellow box contained some large suprises. 

I will have to rely heavily upon com- 
parisons between the two programs. If 
you are one of the two people in the 
universe who do not own Print Shop, the 
decision won't be all that difficult. If you 
do own Print Shop, you may agonize for 
hours before adding Print Master to your 
graphics collection. 

The package contains your disk, and a 
manual that is functional, but not flashy. 
Also enclosed are your registration card, 
and several offers including an additional 
graphics disk, a book on graphics design, 



and a backup disk for five dollars (US). 
At five dollars, I consider a backup disk 
to be a much needed service to the 
customer; anything over ten dollars I con- 
sider to be an exploitive rip-off. 

Print Master's heavy-handed copy pro- 
tection will teach your disk drive to dance 
and sing. That steady 'load' light I've 
come to expect, quickly became a flashing 
strobe light. My 1571 danced and flash- 
ed for a few minutes, and I wonder what 
the 1541 would have done. 

At first glance, the program resembl- 
ed Print Shop, although the first display 
was rather obviously designed for an 80 
column monitor. The title screen was not 
readable, but the following menus were 
just fine. The screen display is black and 
white and offers the choices of Greeting 
Card, Sign, Stationery, Calendar, Ban- 
ner, and Graphics Editor. Printer Setup 
and Exit to BASIC are also included. 

Operation of the program is almost 
identical to Print Shop. A border is 
selected from the menu by highlighting 
the choices. Each choice displays a small 
section of the border, rather than the 
whole thing. The borders are verj' dif- 
ferent than those on Print Shop. They in- 
clude thick and thin lines, a simulated 
wood frame, a paper with a 'drop shadow' 
3-D effect, nouveau-art deco, cars, 
footsteps, 'bang', lace, ants, and 
'christmas'. 

A graphic is selected from the screen 
listing of twelve titles, plus 'next' and 
'previous' pages. But in addition to the 
list of names, you are given the option of 
seeing each of the graphics listed on the 
page. A chunk of twelve are loaded at one 
clip; then by moving the cursor 'highlight' 
up and down, each art cut is displayed on 
the screen. I consider that a big plus. 

After selection of an art cut, you are 
given your choice of three sizes, and 
various positions to place them, including 
staggered and 'tiled' as a background pat- 
tern. The cursor is used to move up or 
down on custom placement, and each 
position is marked by a dotted line that 
revolves much like the flashing lights on 
a movie marquee. 

Next, the type style is chosen. Eight 
fonts are offered, and I like them better 
than those offered by Print Shop, I find 
that I only use two or three of the fonts 
on Print Shop, as some are too large or 
too ornate. The Print Master type fonts 
are more functional, and include both up- 
per and lower case letters. That alone 
makes the package worth purchasing, as 
far as I'm concerned. It means that you 
can fit in longer lines, but provide an all 
capital headline if desired. The spacing is 
proportional, allowing less space for an 



'i' than an 'o'. In most formats, the fonts 
are available in two sizes, and also in your 
choice of solid, outline, or 3-D forms. 

When you start to print your creation, 
the next couple of suprises hit. The pro- 
gram moves the commands to a small 
window, then opens another window and 
draws the completed page on your 
screen . You are then given the chance to 
go back and make corrections if needed, 
and are offered the option of saving the 
page to disk. What a nifty idea! On the 
greeting card section, it draws the front 
of the card, then moves that window to 
the corner, and draws another window to 
create the inside of the card. You may 
edit and correct a design without having 
to reload graphics, as in the Print Shop 
program. 

The program supports Okidata 82A, 92, 
and 192; Okimate 10; Epson RX, FX, and 
MX-Graftrax; Star Micronics lOX/loX; 
C. Itoh 8510; Commodore VIC-1525, and 
MPS-801. The box lists Cardco and Tur- 
boPrint/GT interfaces, but my Xetec 
graphics Sr. worked as well. Print quali- 
ty does not seem to be quite as high as 
on Print Shop, because the occasional 
white lines between printhead passes are 
a bit more noticeable on my Gemini lOX. 

The Calendar option prints either mon- 
thly or weekly versions. You select month 
and year, and you may include a graphic, 
alter the heading a bit, and put some text 
inside an individual day (but only three 
lines of eight characters). The Stationery 
option is similar to Print Shop, but allows 
two lines of text or one large line, and no 
address lines . 

The Graphics editor is similar also, and 
just as limited and frustrating. Draw with 
a joystick, and swap the black and white 
sections, plus flip the picture left to right, 
or flip it upside down, and save it to disk. 
The file created is three blocks long, and 
will load into Print Shop, but is read dif- 
ferently, so it won't be recognizable as 
anything. It resembles the sideways pic- 
ture on a TV set caused by misadjusting 
the vertical hold control . But don't lose 
hope. Some programmer will soon come 
up with a translation program to swap 
artwork back and forth. In the meantime, 
just load up one of the programs and print 
just the graphics, then use a second pass 
through the printer with the other pro- 
gram for your borders and text. 

Do you need both programs? Probably 
not. If you can afford just one — which 
one? Probably Print Master. 

Will I give up either program? Hell no. 

Print Master, by Unison World, 2150 
ShattiLck Ave. #902, Berkeley, CA H70U- 

D 
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Typing Tutor III 
with Letter Invaders 

from Simon & Shuster 

Typing instruction 
program and game 
for Commodore 64 



Review by Malcolm O'Brien 

The first thing you'll appreciate about 
Typing Tutor III is the documentation 
— a lovely hard cover (!) manual with nice 
typeset sheets and a metal spiral binding. 
Full marks to Simon & Shuster's Elec- 
tronic Publishing Division for going the 
extra mile to provide would-be typists 
with high quality materials. The disk is 
inside a plastic 'page' bound into the back 
of the manual. This is preceded by the 
End User License Agreement, which is 
quite similar to the ones you may have 
seen on the slipcases of IBM software 
packages. The Agreement gives you per- 
mission to "make one copy for back-up 
purposes provided you reproduce and in- 
clude the complete copyright notice on 
the back-up copy". This copy is, of course, 
for your own use on your own C-64. Do 
read the Agreement before opening the 
package. 

If you think that I'm talking about 
serious, professional software here, 
you're absolutely right! Simon & Shuster 
(and Borland International, among 
others) are proving that good software 
sells. And 'good' means, in part, that you 
must have a back-up. This has been taken 
into account and provided for in the 
Agreement. Hats off to Simon & Shuster. 

Having said that, let's have a look at 
the programs. Typing Tutor III and the 
Letter Invaders game are the creations 
of Kriya Systems, Inc. The Kriya people 
have incorporated a very clever idea in- 
to Typing Tutor III. So clever, in fact, 
that they have trademarked its name. 
Time Response Monitoring, and its de- 
rived acronym, TRM. According to the 
manual, TRM "notes the time it takes you 
to type each letter and then uses this in- 
formation to create . . . lessons and prac- 
tice tests that encourage you to respond 
automatically and without error, because 
they are specifically tailored to your own, 
unique requirements". 

This facility sets Typing Tutor III apart 
from other tjping programs that you may 
have tried. Since there are many typing 
programs in the public domain, you may 
have one or two of them and you may 
have found (as I did) that they tend to be 



boring and do little to relieve the 
drudgery of typing drills. But Typing 
Tutor III is different. Time Response 
Monitoring affords the user a higher 
degree of interactivity which, in turn, 
leads to a higher degree of user involve- 
ment. Your progress is tracked minute- 
ly, and your results can be displayed on 
a bar graph so that you can examine the 
speed and accuracy of your responses for 
each and every key. Consequently, you 
become more acutely aware of your own 
particular strengths and weaknesses at 
the keyboard. 

The net result of this is great playabili- 
ty , for want of a better word. Every time 
I run this program I wind up typing for 
hours. And when I stop, it's not because 
of boredom or frustratibn but simply 
because other tasks require my time and 
attention. Or because I should have been 
in bed an hour ago! Kriya is a Sanskrit 
word whose root meaning is 'do' and this 
program certainly keeps me 'doing'! 

I wanted to find out if others would be 
affected in the same way by the program, 
so I corralled a friend into my chair while 
Typing Tutor III was on the screen. 
She's a competent typist but tries to steer 
clear of computers. Nevertheless, after 
a very few words from me (more of en- 
couragement than of instruction), she 
began to work with the program, follow- 
ing the on-screen instructions. About an 
hour latter, I concluded that Typing 
Tutor III really was as engaging as it 
seemed to me to be and I told her that 
she could stop. "Just let me do a few 
more", she said. 

The programs include on-line help and 
instruction screens that are memory - 
resident and therefore don't require disk 
accesses. Of course, this means that they 
are loaded in every time that you use the 
program. This is a feature that I really 
dislike in a program, but I think that I am 
in the minority in this regard and that 
most users will appreciate having all the 
instructions immediately available. Still, 
I wish that we had a choice about loading 
the help. Typing Tutor III and Letter In- 
vaders are long programs (191 and 134 
blocks respectively). Fortunately both of 
them work with Fast Load. On the 
positive side, the information on the 
screens is clear, concise and complete. 
You may not need that wonderful 
manual. 

From the main menu you have seven 
choices; Alphabet Keys, Number Keys, 
Words Test, Full Keyboard Test, 
Numbers Test, Standard Speed Test and 
Status Report. Alphabet Keys is the place 
to start if you're a neophyte. Number 
Keys is the place to go if you're one of 



those people who still have to look at the 
keyboard when confronted with digits. 
Initiates may elect to go directly to Word 
Test or Numbers Test, and the adepts 
among you may opt for the Pull Keyboai-d 
Test or Standard Speed Test (which 
always shows the same text unfortunate- 
ly). If you select the word or number tests 
after completing a lesson, only the keys 
you've been working on are included. 

The status report is another excellent 
feature of this program. From the status 
report you can change the program 
variables. Specifically, you can turn the 
sound on or off, change the threshold at 
which a key is considered fast, change the 
number of lessons that are presented 
before a Progress Report is displayed, or 
alter the number of lines in a test. This 
is great for adjusting the program to 
adapt to the differing needs of users — 
from the hunt-and-peck crowd to the 
speed demons. 

The program gives very good reports 
on your performance, showing which 
keys have been typed 'fast', which keys 
have been mistyped, your accuracy (ex- 
pressed as a percentage), your actual 
speed and your corrected speed (using the 
standard method of subtracting five 
words per minute for each error). 

The game. Letter Invaders, is more fun 
than Typing Tutor III and offers almost 
as much performance information. The 
idea for the game has been used before 
but this is a first-class implementation. 
Characters fall from the sky endlessly. 
Evidently they are not at all intimidated 
by your land-based lasers, which 
obliterate the attackers when the correct 
characters are typed. Any missed 
characters will decimate the landscape. 
This is a great challenge and a tremen- 
dous responsibility rests on your 
shoulders. If its safety depended on me, 
frankly, the earth would be doomed. I'm 
not terribly fast (50 + wpm) but I have 
very good accuracy. Still, I was no match 
for the invaders; although I did manage 
to pick up a lot of bonus points for triads 
(three successive keystrokes for one 
finger). Where I really got creamed was 
on the special symbols. I use a PC/XT at 
work all day and then come home and flub 
all the keys that are in different locations 
on the 64. Certainly the game taxes your 
skills, and fairly demands that you 
become a better typist. You'll do it too. 
And you'll have fun in the process. 

So for your next keyboard meditation, 
concentrate your mind on Typing Tutor 
III and let Kriya be your guru. It could 
be a (third) eye-opening experience! 

Typing Tutor III with Letter Invaders, 

from Simon & Shuster. D 
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starting FORTH 
by Leo Brodte 

Prentice Hall 

Softcover. 360 pages 

Price $20.00 (US) 



Review by R.C. Walker 

Written in the same matter-of-fact style 
as his Thinknig Forth, Leo Brodie's Star- 
ting FORTH is an invaluable reference 
for FORTH programmers at all levels of 
expertise. Since it is also a tutorial , there 
are several exercises, with answers, in- 
cluded for each chapter. If you want 
FORTH, you will also want this book. 
Let's look at each chapter in turn: 

Fundamental FORTH: This chapter ex- 
amines the properties of the language, 
and the design of FORTH words. 
FORTH programming consists of 
developing new words (commands) from 
previously defined words. Although 
FORTH is compiled, it is also interactive. 
Words can be executed simply by typing 
them and hitting the RETURN key. Ap- 
plication source code is normally saved on 
disk in blocks of 1024 characters each 
('screens'), which are compiled into the 
system before executing. Alternatively, 
a completed application can be saved and 
loaded as a precompiled file. FORTH's 
parameter stack and postfix 
mathematics, the sources of much of the 
language's speed and power, are in- 
troduced here. 

How To Get Results: In this chapter, 
FORTH mathematics is dealt with more 
deeply. Floating point words, though 
sometimes provided as an option , are not 
dealt with, since integer mathematics are 
standard (for reasons of speed), and there 
are methods for overcoming integer 
shortcomings (dealt with in a later 
chapter). Stack manipulation words are 
studied and used. 

The Editor (And Staff): This chapter 
provides a description of a simple editor 
that allows one to create source code. It 
is written in FORTH, and takes the form 
of a separate vocabulary, since many 
words may otherwise be identical to some 
used in FORTH's main vocabulary. Com- 
ments may be freely added, since they are 
not compiled into the dictionary and, 
therefore, do not slow down execution 
time, as in interpreted BASIC. 

Decisions, Decisions: FORTH, like any 
other language, uses logical operators for 



decision making. These, and FORTH's IF 
ELSE THEN constructs are detailed. 

The Philosophy Of Fixed Point: The use 

of integer mathematics is expanded upon 
in this chapter. In addition to the basic 
mathematics operators, other handy 
words are provided. These include the 
often-used fast operators (to add or sub- 
tract 1 or 2, and to multiply or divide by 
2), miscellaneous operators, and words to 
manipulate the computer's return stack. 
Technical and philosophical aspects of fix- 
ed and floating point mathematics are 
touched upon. FORTH can often over- 
come the problem of not having floating 
point through the use of scaling operators 
and complementary rational approxima- 
tions, as explained in this chapter. 

Throw It For A Loop: FORTH's many 
loop structures are explored. The vari- 
ations in the DO LOOP construct allow 
for some sophisticated applications. 

A Number Of Kinds Of Numbers: This 
chapter explains the various types of 
numbers (bytes, single-length, double- 
length, signed, unsigned, ASCII) used by 
computers, and by FORTH in particular. 
FORTH's normal single-length numbers 
are 16 bits in length (allowing a range of 
over 65,000), while double-length 
numbers use 32 bits (for a range of over 
4 billion). This should allow for more than 
ample precision, using scaling where ap- 
propriate. A useful property of FORTH 
is that practically any number base may 
be used without conversion. Binary, 
decimal , hexadecimal or a non-standard 
base may be used where appropriate. 
Logical operators and a relatively simple 
number formatter are also touched upon 
in this chapter. 

Variables, Constants and Arrays: These 
items are used in FORTH in much the 
same way as in other languages. The use 
of constants, in particular, is encourag- 
ed, since there is no speed penalty, yet 
they aid in documenting the source code. 
Single dimension arrays and their uses 
are examined. Factoring, a programming 
development concept especially suitable 
for FORTH, is introduced here. 

Under The Hood: This chapter examines 
the technical aspects of the FORTH 
language — what makes it run. First up 
is the interpreter, followed by vectored 
execution, a very useful programming 
technique. The dictionary structure 
shown is not that of all FORTH im- 
plementations, although the principles 
will be similar. The author shows how 
new definitions are added to the 
vocabulary. Also, FORTH's use of buf- 
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fers, the scratch pad, variables and 
vocabularies is examined. 

Most FORTH implementations include 
an assembler vocabulary but, since each 
one is patterned after the particular pro- 
cessor for which the system is set up, it 
is not detailed in this book. 

I/O And You: Discussed in this chapter 

is how FORTH handles input and output 
(mostly character strings to and from disk 
block buffers), and other data movement. 
BASIC programmers who have used 
FOR NEXT loops to transfer a block of 
data or fill an array will appreciate the 
speed of FORTH's move commands. 
Manual commands for transferring infor- 
mation between computer and disk drive, 
often handled automatically as a virtual 
memory system, are also presented. 

Extending The Compiler: Defining 
Words And Compiling Words: FORTH 
is a compiled language. The compiler 
modules can easily be added to, as simp- 
ly as defining a short line of source code. 
'Defining words' specify the behaviour of 
words when they are compiled and when 
they are executed (interpreted). For ex- 
ample, variables and constants use dif- 
ferent compile code. This results in dif- 
ferent behaviours when executed. How 
many languages allow the programmer 
such powerful methods of extension? 

A non-traditional flowcharting method 
is also briefly discussed in this chapter, 
in order to more deeply examine two im- 
portant FORTH words, the interpreter 
and the colon compiler. 

Three Examples: Three programming 
examples are presented, primarily to 
teach FORTH style. Good style ensures 
a superior product, no matter what one's 
endeavour. By putting into practice such 
elements as simplicity, structure, ap- 
propriateness and following FORTH con- 
ventions, one will help to ensure that 
their finished product is elegant. 

The first example is a word game that 
prints randomly -chosen phrases. The pro- 
ifram is cleverly set up so that the out- 
put seems almost coherent. The second 
example is a simple database implemen- 
tation . The third example demonstrates 
how integer FORTH can handle problems 
that normally must depend upon floating 
point mathematics. 

Whether your pleasure is learning 
FORTH, or just examining some aspect 
of the language, you may be hard press- 
ed to find a better book. It does not mat- 
ter whether you are a novice or an ad- 
vanced programmer, as this book is far 
more than an introduction to FORTH. In 
my library, it is a valued reference. D 
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Trolls and 
Tribulations 

from Creative Software 

Arcade-style game 
for Commodore 64 



Review by Robert Sodaro 

You are a troll. Ail your life you have 
lived ivith darkness, dank mwsiwtess, and 
the overpowering stench you could cleave 
with a dull blade. Danger lurks 
everywhere: carnivorous 'cretins', low- 
flying buzzards, troll-crushing 'skulls' 
and poisonmis spiders. There are also the 
ever-present rising waters, rank with raw 
sewage from the overworld. . . 

This is the real world of Creative Soft- 
ware's Trolls and Tribulations. Games 
today tend to combine elements of 
previously-established hits into new pat- 
terns, and Creative Software has certain- 
ly done this with Trolls, producing a uni- 
que and humorous blend of two arcade 
classics: Tutankhamen and Mario Bros. 

From Mario Bros.. Trolls lifts the 
single-screen, multilevel maze, where 
deadly beasties drop from above to hunt 
you down. In Trolls, the troll (equipped 
with an eight-shot pistol) must first shoot 
the attacking cretin, then knock the 
resulting 'egg' into the murky waters 
below. Coupled with this are a series of 
Tutankhamen-like mazes, where trolls 
must gather up treasures by traversing 
narrow corridors and leaping across 
great chasms. 

Trolls forces the player to plan each 
move with care and precision. A light 
touch and a measure of forethought are 
required, or your hapless troll will wind 
up overplaying his hand and tumbling to 
his doom. 

At the outset of the game, you are re- 
quired to pick the level of play (novice, 
intermediate or expert) by opening the 
appropriate door. Your expedition of 
eight then enters the first set of mazes. 
The entire maze is a actually a multilevel, 
horizontally-scrolling screen, sectioned 
off into levels, each fraught with its own 
particular set of dangers. Cretins (both 
gi'een and red) can be killed, but skulls, 
buzzards and spiders cannot. 

Locked doors appear at each end of all 
maze sections (the maze scrolls off to the 
right), and can only be opened by acquir- 
ing the proper keys. Keys (and treasures) 
are easily obtainable, by either leaping 
from ledge to ledge or dropping to shelves 
below your position. And fear not — long 



Falls will not harm you. (Unless, of course, 
you land in the water and drown). 
Strategically-placed trampolines are 
situated to assist in reaching higher 
ledges. Leaping skulls and buzzards in the 
confines of the low tunnels may inhibit 
you, at first, but no harm will befall you, 
since you soon discover that you can't hit 
your head. 

The lower levels are easy enough to 
master but, as you progress deeper in the 
maze, you will need a greater degree of 
skill. Higher levels of play at the deepest 
sections will prove to be a true challenge 
for hardcore gamers. The progression 
from the first sections to the deeper and 
more difficult ones, however, is gradual 
enough to ensure continued interest as 
ability increases. . 

Trolls is a delightful game, but I do 
have two complaints. First, there is no 
way to bypass higher sections and begin 
deeper in the maze — you must always 
start in the first maze of each level, pro- 
gressing through old territory before 
entering new ground. Second, a high 
score is provided, but there is no way to 
save the information to disk (the instruc- 
tions speak of 'memory limitations'). Who 
cares that / can keep track of the high 
score in a single sitting — I want the next 
fellow booting up the game to know how 
good I am! 

Still, Trolls and Tribulations is well 
worth its weight in mystic amulets. 

Creative Software, 230 East Caribbean 
Drive, Sunnyvale, California 9A089. D 



Mapping The 
Commodore 64 

by Sheldon Leemon 

COMPUTE! Books, 1984 
268 pages, $14,95 (US) 



Review by Ranjan Bose 

Without denigrating the excellence of the 
Commodore 64 in a large number of 
serious applications, as a reasonably- 
priced yet powerful microcomputer, it is 
also ideal for learning how to program. 
The C-64 has excellent graphics and 
sound capabilities, but if you really want 
to make it run for the money, you have 
to learn about its logical organization, and 
you have to dabble in machine language. 
Over the years, a lot of literature has 
accumulated concerning the various 
aspects of Commodore computers, 
especially the C-64. Mapping The Com- 
modore 6Ji is very well organized, and is 



one of the most glitch-free reference 
manuals available. It describes all the 
memory locations in the C-64 operating 
system in reasonable detail, and also in- 
cludes subroutines for performing many 
different programming feats. The book 
is a must for understanding what each 
register does, and how the operating 
system utilizes the different memory ad- 
dresses and banks to perform program- 
ming magic. 

One tends to shy away from reading 
about memory maps, because most of 
them make rather dry reading, with fun- 
ny names for addresses and a presenta- 
tion that is unavoidably disjointed and 
terse. Mapping The Commodore 64 is dif- 
ferent. It is very lucid, and actually makes 
rather interesting reading. I just wore out 
my first copy after several months of ex- 
tensive handling, and am rushing to get 
another one before my programming 
comes to a standstill. Q 



Graphics Book For 

The Commodore 64 

by Axel Plenge 

Abacus Software, 1 984 
280 pages, $19.95 (US) 

i 

Review by Ranjan Bose 

Sooner or later, you have to grow out of 
conservative BASIC programming, and 
start ventm-ing into the other avenues the 
C-64 makes available. Sound and graphics 
programming are available from BASIC, 
but the slowness of BASIC routines soon 
brings you to the menu of options. These 
are: stay back if you are a chicken; buy 
an extension package , but forget about 
exchanging or selling your programs; or 
learn the nuts and bolts (machine 
language routines, handling VIC/SID 
routines, registers and interrupts); and 
lastly, buy a C-128 or Amiga. 

For the nuts and bolts handyman, this 
book from Abacus is a great help. By the 
time you finish reading it, you will 
understand how to move screens, design 
character sets and sprites, and the 
mechanics of interrupt programming. Us- 
ing the programs provided (sprite editor, 
character set editor, high-res routines, 
and so on), which are also available on an 
optional accompanying disk ($14,95 US), 
and after studying the book several times, 
programming graphics will hold no ter- 
rors for you. From then on, your dedica- 
tion and creative imagination will deter- 
mine how far you go. Highly 
recommended. D 
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Superman — 
The Game 

from First Star Software 

Arcade game for 
one or two players 
for Commodore 64 



Review by Malcolm O'Brien 

I started reading before I went to school, 
and Superman was probably the first 
publication that I read regularly. Over the 
years, wherever Superman went, I 
followed — the comics, the television 
show and the movies. I've been a Super- 
man fan for over thirty years. Since 
Superman is not bound by time or space, 
it seems perfectly natural that he should 
now appear on my monitor screen as well. 

My children, Grace (10) and Sean (9), 
are big Superman fans too. Thanks to the 
miracle of videocassettes, they have seen 
the movies numerous times — occasional- 
ly watching the same film three times in 
a weekend! They both got very excited 
when I told them I would be reviewing 
the game for TPUG Magazine. So we all 
gathered around the C-64 on a Saturday 
afternoon (and evening!) to put the Man 
of Steel through his paces. 

Superman — The Game is the first in 
a new series of programs from First Star 
Software. The series is called the 'Super 
Powers Software Collection', and I ex- 
pect that it will be well received by game 
players at large. This is an arcade-style 
action game, although there are strategic 
aspects as well. 

As with other offerings from First Star 
Software, the program's greatest 
strength is in its graphics. The opening 
screens are superb. When the program 
appears, Superman flies over the 
Metropolis skyline and pauses to wave to 
you. Then an excellent portrait of Supes 
'dissolves' onto the screen, accompanied 
by suitable music. This gives way to a por- 
trait of the evil villain, Darkseid, and the 
music becomes sinister. Real scary, kids! 
The last screen in the opening has the 
famous Superman logo and the program 
credits. The program was written by Jim 
Nangano and Fernando Herrera. 

Mr. Herrera has made quite a name for 
himself as a creator of microcomputer 
graphics. A few years ago, Atari ran a 
contest for user-written programs, which 
was won by Mr. Herrera. His winning 
program. My First Alphabet, was writ- 
ten for his young son. Although it has no 



educational value for anyone older than 
the Sesame Street set, the excellent 
graphics and the overall quality of the 
program were probably what caught the 
eye of the Atari judges. Mr. Herrera's ef- 
forts won him the first (only?) Atari Star 
award, and he then started First Star 
Software. He's been keeping the VIC II 
chip (not to mention the Pokey chip in the 
Atari) busy ever since. 

Superman is no exception. Game action 
is very fast and very complex, graphical- 
ly and strategically. You have to keep 
track of a number of game parameters to 
tip the scales in your favour. Here's the 
setting: 

There are six Metropolis game screens. 
Three of them represent the streets of 
Metropolis, and the other three represent 
Darkseid's network of caves beneath 
Metropolis. When moving between 
screens, the two combatants do battle on 
the groun d , under the groun d , i n the air , 
and in outer space. These transitional 
screens, called 'Combat Zones', can be 
very challenging exercises in themselves 
— the documentation describes them as 
"games within The Game". The Combat 
Zones are, once again, very appealing 
graphically, and a little bit easier to get 
a handle on than the Metropolis screens. 
At the beginning of the game, you can 
elect to play with or without Combat 
Zones. When you're new to The Game 
you may find that including the Combat 
Zones is the only way you can exercise 
a measure of control over the game! 
Although some points are won or lost in 
the Zones, it's the Metropolis screens that 
will make or break you. 

Effectively, the six Metropolis screens 
constitute one large maze, which is 
populated by the citizens of Metropolis 
who will be captured or rescued during 
the course of the game. The citizens 
wander zombie-like through the streets 
and caves. They will blithely walk into 
Darkseid's prison without a second 
thought. The citizens are none too bright, 
and really need Superman's help! Each 
person rescued adds to Superman's score, 
and each one captured adds to 
Darkseid's. Actually, the score has three 
components — points, energy remaining, 
and number of people rescued or cap- 
tured. Two of these, energy and people, 
can decide the contest. Whoever runs out 
of energy first loses. In the beginning, 
this will probably be you! The game can 
also conclude when all the citizens have 
been captured or rescued. In this case, 
the player with the highest people score 
is the winner. With time, as you improve, 
you may win on energy; later on, by con- 
serving energy and playing strategical- 
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ly, you'll start to win games on people. 
Playing the game effectively consists 
chiefly of knowing which of the four main 
game activities to perform at any given 
time. The four main actions are; 
assaulting your opponent directly, 
transporting citizens, rotating deflectors, 
and obtaining dimensionizers (used for 
travelling from screen to screen). 
Assaulting your opponent can be done 
bodily or by means of beams (Superman's 
heat vision or Darkseid's Omega beam). 
The deflectors serve the dual purpose of 
redirecting both the beams and the 
citizens of Metropolis. 

At first I felt that the game was too 
hard. Darkseid seemed to be too smart 
and too fast. Strangely, he seems to be 
able to walk faster than Superman can 
fly! Sometimes, when first entering a new 
screen, Darkseid and Superman appear 
in the same spot. This 'freezes' you, which 
results in a serious energy loss, and you 
are helpless until Darkseid decides to 
move away. To be fair, you can 
sometimes use this same technique 
against your opponent: either to 'buy 
time' when the citizens are moving your 
way, or simply to deplete your opponent's 
energy reserves. While this ploy enhances 
the game strategically, it also diminishes 
the action. Although different players will 
react to this in different ways, there were 
times when I found it downright 
frustrating! 

Aside from this minor complaint, the 
program has one serious flaw that I 
would like to see corrected. At the end 
of the game, when playing against the 
computer, the winner is seen flying 
triumphantly over the Metropolis skyline. 
In the two-player mode, however, the 
game ends abruptly and returns you to 
the 'Selections' board with no indication 
of who has won the game! David Bradley 
and I played the game for several hours 
one evening, and this happened to us 
several times. On one occasion we were 
returned to the 'Selections' board before 
either of had bothered to check our scores 
for the first time! On another occasion the 
Metropolis map showed that there were 
still unaccounted-for citizens; but we 
couldn't find anyone on any of the six 
screens! 

In spite of these problems, which mar 
an otherwise excellent game, I would still 
rate the program highly. It will provide 
users with many hours of fun and 
entertainment. 

Superman — The Game, jrom. First Star 
Software, 18 East 41st Street, New York, 
New York 10017. D 
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Products Received 



Presented by Astrid Kumas 

The following products have been received 
by TPUG Magazine in recent weeks. 
Please note that these descriptions are 
based on the manufacturers' own 
announcements, and are not the result of 
evaluation by TPUG Magazine. 

Programs for the C-64/128 

COMPUTE! 's Commodore 61,1128 Collec- 
tion from COMPUTE! Publications, 
Inc. 324 W. Wendover Avenue, Suite 



200, Greensboro, NC 27408, (919) 
275-9809. Price: $12.95 (US). 

Hard on the heels of the C-128 release, 
COMPUTE! Publications Inc. came up 
with a new title, COMPUTE'.'s Corn- 
modore 6Jtll28 Collection. The book, on 
sale since June 1985, contains ready-to- 
type -in programs for the C-64 and C-128 
in its 64 mode. 

Besides the programs, the book in- 
cludes information on the Commodore 
128. The opening chapter, entitled Inside 
the 128, describes new features of the 



C-128: CP/M, BASIC 7.0. 128 mode and 
peripheral ports. 

There is also a chapter on programm- 
ing: it offers hints on debugging BASIC 
programs and suggestions for writing 
text-adventure games. 

As for the programs presented in the 
book, they range from games, sound and 
graphics applications to programming 
utilities, and have been grouped accor- 
dingly in three sections: Recreation and 
Education, Sound and Graphics, 
Utilities. 



News from Cardco 

At the January 1986 CES in Las 
Vegas, Cardco exhibited its two 
StealthTec utilities, described as the 
first across-the-board transparent pro- 
gram interrupt technology for Com- 
modore computers. 

A transparent interrupt mechanism 
is one which can be called upon during 
the execution of another program . It 
will then 'disappear' when not needed, 
leaving the previous program intact, 
exactly as it was when the transparent 
interrupt was called upon. 

Freeze Frame, the first StealthTec 
program, is a totally transparent 
screen dump utility. With a couple of 
keystrokes, it will immediately send 
whatever is on the screen right to the 
computer's printer. Freeze Frame is 
unique for two reasons: it works on vir- 
tually all programs and aii programm- 
ing languages, and it supports any 
printer or printer interface which 
emulates the Commodore 1525, as well 
as any Epson-compatible or any 
Okidata -compatible printer. 

Second program in the StealthTec 
series is a business/productivity utili- 
ty, yet unnamed. It will provide instant 
access to a calculator, an appointment 
calendar, a telephone direc- 
tory/database, a memo writer, a screen 
dump utility, access to all DOS func- 
tions, and more. 

Cardco will produce the initial 
StealthTec programs for the Com- 



Still Sizzling. . . 



modore 64. Versions for the Com- 
modore 128 will follow soon. For more 
information on StealthTec programs 
contact Cardco, Inc. 300 S, Topeka, 
Wichita, KS 67202. 

Cardco announces also an affordable 
hard disk drive for the Commodore 
64/128 computers. The company claims 
that its Hard Disk Drive is virtually 
transparent to all programs, and offers 
the following features: 

• choice of three memory capacities: 5 
megabytes, 10 megabytes, or 20 
megabytes; 

• high-speed operation (50 to 70 times 
the speed of the Commodore 1541 disk 
drive); 

• expanded Commodore DOS com- 
mands for greater programming 
strength; 

• total transfer of copy-protected 
programs. 

Cardco 's projected retail prices for its 
Hard Disk Drive will be $599.95 (US) 
for the 5-megabyte model, S899.95 
(US) for the 10-megabyte, and 
$1,299.95 (US) for the 20-megabyte 
version. Cardco plans that deliveries of 
the C-64 models will begin late in the 
first quarter, with the C-128 models to 
follow shortly. 

New Amiga Products 

Brown -Wagh Publishing is now shipp- 
ing three new productivity tools in- 
cluding a spreadsheet, telecommunica- 
tions and bulletin board program for 



the Amiga personal computer. 

The spreadsheet program, called 
Analyze!, can be used for financial 
analysis and planning, bookkeeping, 
home budgets, check registers and 
more. Loaded with features similar to 
Lotus 1-2-3, Analyze! can produce 
professional -sized spreadsheets (256 
columns by 8,156 rows). 

OnLine! is a telecommunication pro- 
gram that transforms the Amiga into 
a terminal that is capable of interac- 
ting with micros and mainframes. The 
program can also link up with commer- 
cial information services, as well as 
send telex messages and electronic 
mail worldwide. 

Last program, BBS-PC, is a ver- 
satile electronic bulletin board system 
that transforms any Amiga into an 
online information network. It inter- 
faces to a hard disk or keeps up with 
a 2400bps modem. 

All three programs were written by 
Micro-Systems Software Inc., and are 
being distributed by Softeam 
(1-800-847-6383), National Software 
Distributors (800-821-3612) and Com- 
puter Software Services (800-422-4912) 
in the U.S., and by Phase 4 Distributors 
(403-252-0911) in Canada. 

Analyze! and BBS-PC retail for 
$99.95 (US), while OnLine! retails for 
$69,95 (US). For additional product in- 
formation contact: Brown-Wagh 
Publishing, 100 Verona Court, Los 
Gatos, CA 95030 or call 408-395-3838. 

a 
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To make program entry easier and 

error-free, the publishers included in the 
Appendices general guidelines on typing 
in program listings, an error-checking 
program called Automatic Proojfreader, 
and the machine language entry program 
MLX. However, some readers will cer- 
tainly appreciate the convenience of buy- 
ing from COMPUTE! Publications a disk 
with all the programs found in the book. 
The cost of the disk is $12.95 (US), and 
the toll free number to call and order it, 
is 800-334-0868. 

Assembly Lagguage: 
C-128 Update 

Assembly Langiigefor Kids: Commodore 
64 with Commodore 128 Update by 
William B. Sanders, published by 
Microcom scribe, 8982 Stimson Ct., San 
Diego, CA 92129. Price: $14.95 (US). 

William Sanders* book was reviewed in 
the August/September 85' issue of TPUG 
Magazine, and was highly recommended 
by our reviewer Michael Quigley. Since 
then, Microcomscribe has sent us an up- 
dated version of its publication — 
Assembly Langtutge for Kids: Commodore 
61f with Commodore 1Z8 Update. 



The Update comes as a separate 
29-page booklet, neatly fitting inside the 
main book. It contains the book's pro- 
grams all reconfigured for programming 
in the Commodore 128 Mode using the 
built-in mini -assembler. In addition, a 
C-128 memory map, new BASIC 7.0 
tokens, C-128 Sprite Assembler with the 
new addresses for sprite storage, infor- 
mation on switching memory banks, as 
well as instructions in using the monitor 
and mini-assembler have all been 
included. 

It is also worth mentioning that the Up- 
date lists in the new Errata a number of 
errors which slipped into the original 
printing of the book. 

C-64/128 Portfolio Manager 

Personal Portfolio Manager for the 
Commodore 64 and 128 from Abacus 
Software, Inc., P.O. Box 7211, Grand 
Rapids, MI 49510. Price: $39.95 (US). 

This new product from Abacus Software 
has been designed for investors who need 
a portfolio management and analysis 
system. The program runs on the Com- 
modore 64, SX-64 and Commodore 128 
in its 64 mode. 



Personal Portfolio Manager can be us- 
ed as a tool in three main areas of per- 
sonal investment: 

• Portfolio Management and Analysis — 
to compile various transactions in a port- 
folio and to report its performance; 

• Fundamental Analysis — to select suc- 
cessful investments according to the 
users' particular criteria; 

• Technical Analysis — to study past per- 
formance of a security in order to predict 
its future. 

The program will handle up to one thou- 
sand open transactions on a single 
diskette. 

An interesting feature of the Personal 
Portfolio Manager is that the quotes can 
be entered manually or automatically 
through Dow Jones or Warner Computer 
Syslems. For this purpose a Vicmodem, 
Commodore 1650, or a 1660 modem can 
be used. 

The user has also an Autorun feature 
which enables the user to set time for the 
system to log on, update quotes, log off, 
and print reports. 

Personal Portfolio Manager comes 
with a manual divided into the following 
sections: Getting Started, Tutorial, 
Reference and Appendices. Q 




Limited time offer 
$11.00 
$14.00 

(Minimum purchase - 5. Delivery extra.) 



Switch 

to the highest 
quality, lowest 
priced brand name 
disl(ettes available 
in Canada. 

Q. Who has switched? 

A. Professional and educational 

institutions, national accounting 
firms, major engineering firms, 
software houses, computer 
retailers and the Toronto Pet 
Users Group. 

In Bulk - 3V2 inch discs 
SSDD $3.50 each / DSDD $4.00 each 
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Programmers Guild Products Ltd., 255 ManuLife Place, 10180 - 101 St., VISA 
Edmonton, Alberta T5J 3S4 Phone: (403) 428-6229 
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Calendar of TPUG Events 



Meeting Places 

Amiga Chapter: The new Amiga chapter meetings will be held 
in conjunction with the Westside chapter meetings, 
Brampton Chapter: Brampton Public Library, Four Comers 
Branch, 65 Queen St., on the second Thursday of the month, 
at 7:30 pm. 

Business Chapter: TPUG Office, 101 Duncan Mill Rd., Suite 
G.7, Don Mills, on the second Wednesday of the month, at 7:30 
pm. 

Central Chapter: The Central Chapter will no longer be 

meeting. 

COMAL Chapter: York Public Library, 1745 Eglinton Ave. W. 
(just east of Duffer in) on the fourth Thursday of the month, at 
7:30 pm in the Story Hour Room (adjacent to the auditorium). 
Commodore 128 Chapter: TPUG Office, 101 Duncan Mill Rd., 
Suite G-7, Don Mills, on the first Wednesday of the month, at 
7:30 pm. 

Commodore 64 Chapter: York Mills CI, 490 York Mills Rd. (east 
of Bayview) on the last Monday of the month, at 7:30 pm in the 
cafetorium . 

Communications Chapter: TPUG Office, 101 Duncan Mill Rd., 
Suite G-7, Don Mills, on the fourth Wednesday of the month, 
at 7:30 pm. 

Eastside Chapter: Dunbarton High School (go north on Whites 
Rd. from the traffic lights at Highway 2 and Whites Rd. to next 
traffic lights; turn left to parking lots) on the first Monday of 
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the month, at 7:30 pm. 

Hardware Chapter: TPUG Office, 101 Duncan Mill Rd., Suite 

G-7, Don Mills, on the second Tuesday of the month, at 7:30 pm. 

New Users Chapter: TPUG Office, 101 Duncan Mill Rd., Suite 
G-7, Don Mills, on the third Monday of the month, at 7 pm. 

SuperPET Chapter: York University, Petrie Science Building 
(check in room 340). Use north door of Petrie to access building. 
On the third Wednesday of the month, at 7:30 pm. 

VIC 20 Chapter: York Public Library, 1745 Eglinton Ave. W. 
(just east of Dufferin), on the first Tuesday of the month, at 7:30 
pm in the auditorium. 

Westside Chapter: Clarkson Secondary School, Bromsgrove 
just east of Winston Churchill Blvd., on the third Thursday of 
the month, at 7:30 pm, 

68000 Chapter: The meetings of the new 68000 chapter will be 
held in conjunction with the meetings of the SuperPET chapter. 

TPUG makes every effort to ensure that meetings take pkux when 
and where scheduled. However, unforeseen problems may occa- 
sionally arise that lead to a particular meeting being changed 
or cancelled. The TPUG meetings line (U5-90W) is the best source 
of fully up-to-date information on meeting times, and should be 
consulted. 

Are you interested in organizing some other interest group in 
the Greater Toronto area? Please let the club office know, by mail, 
phofne or TPUG bidletin board. Q 
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Bulletin Board 



Richvale reborn 

Rtchvale Telecommunications, was one of the pioneer 
developers of Cominodore software and hardware in the 
Toronto area. It bore She very individuaiistic stamp of its 
owner, Peter Smith, and was locally famous for both its 
creative ferment and its chaotic approach to business — 
which may. after ail, have been two sides of the same coin. 
Among their better-known products were a word processor, 
Script 64; a copying utility, Supercopy; and and IEEE in-. 
terface for the 64, the C-Link. 

Richvale went out of business a whiie ago, after a long, 
unsuccessful struggle to stay afloat, and their passing seem- 
ed like the end of an era (eras being shorter these days than 
they used to be). 

But a few weeks ago, Smith's wife, Barbara, announced 
{he formation of a new firm, Rich-Hill Telecom International, 
to take over where Richvale left off. Rich-Hili will be marketing 
the same hardware and software, line as Richvale, 

RiCh-Hill will be kicking things off with an open-house and 
sale on March 14th (evening) and 15th, which we hope is 
some time after you read this. Peler and Barbara invite old 
customers, well-wishers and other interested parties to join 
them for the event in their headquarters at 200 West Beaver 
Creek Road, Richmond Hill, in the Beaver Park industrial, 
park (near highways 7 and 404). For additional info, call 
731-1621. 

Racter replicated 

Our prayers have been heard, it seems, for Racter has 

added a new persona to its particular form of Artificial In- 
sanity. Racter's iegal guardian, Mindscape Inc., has allowed 
the silicon scribe to enter the mind of the Amiga, Our human 
brains boggle at what this prolix program will do with 
multitasking. 

Distressed? Call this number. . . 

David Bradley of the Bradley Brothers' Bulletin Board 
System has announced a new 'freeware' service. The 
Distressed Commodore Users' Hotline is for those having 
difficulties wilh their new machines. Business hours are 2:00 ; 
. pm to 10:00 pm, Monday to Friday at (416) 488-4776. For 
further information about the service, write to Distressed 
Commodore Users' Hotline, 147 Roe Avenue, Toronto, Ont- 
ario, Canada M5M 2H8. Those with modems can also call 
any of the Bradley Brothers' Bulletin Board Systems at (416) 
487-5833, 481-8661 . 481-9047, 277-9991 , 24 hours a day, . 
7 days a week. 

A mention ... 

Robert Adier, of the C-64 Users Group of Canada, is mad 
at us because we keep forgetting to mention the existence 
of his club. The dub produces an excellent newsletter. Hard- 
copy, and operates both a Help Hotline, at (514) 739-3046, 
1 am !o 1 pm daily; and a BBS called Micropolis, at (51 4) 
739-3446, The address is Snowdon P.O. Box 1205, Mont- 
real, Quebec, H3X 3Y3. Peace is restored. D 
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DIRECT FROM THE AUTHORS WITH A 30 DAY SATISFACTION 
GUARANTEE PLUS CONTINUING SOFTWARE SUPPORT 




Classifieds 

This space Is for the ads of TPUG members. Wanted 
or for sale items only. Cost is 25 cents per word. No 
dealer ads accepted. 

Unclassjfieds 

For Sale; 8032, 4040, ADA 1450, Wordpro A + , InfoPro, 
all for $500.00 (US) or best offer. Call John (201) 263-4538 
(evenings)- 

For Sale: SuperPET, 8050 drive, modem, with software — 
OS/9, Stylograph with Spell Check and Mail Merge, C 
Language, 7 Waterloo interpreters, Datamanager. BPI 
General Ledger and Job Costing Module, VtsiCalc, Word- 
Pro 4 Plus. $2,000.00 or best offer. Call Neil Stone, (416) 
440-0368, business hours. 

For Sale: 4032-N CPU $300.00. 4040 Drive $650,00. 4023 
Printer $200.00, $850.00 for whole system. All units with 
documentation. R. Hyam, 225 Cambie Road, Kelowna, 
British Columbia, VI X 3H9, (604) 765-5215. 

For Sale: SuperPET system, including 8250 disk drive, 2023 
printer, WordPro 4 Plus, VisiCalc, other software and 
manuals. $2000.00 complete, or best offer on system of 
component(s). Gordon Ritchie, (416) 626-5442. 
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Ask Someone Who Knows 

If you enjoy Jim Strasma's many books, and his 

articles in this and other magazines, you'll be glad 
he also edits his own highly-acclaimed computer 
magazine, now in its sixth year of continuous 
publication. Written just for owners of Com- 
modore's many computers, each Midnite Software 
Gazette contains hundreds of brief, honest 
reviews. 

Midnite also features timely Commodore 
news, hints and articles, all organized for instant 
reference, and never a wasted word. Whether you 
are just beginning or a long-time hobbyist, each 
issue will help you and your computer to work 
together effectively. 

A six issue annual subscription is $23. To 
subscribe, or request a sample issue, just write: 

MIDNITE SOFTWARE GAZETTE 

P.O. Box 1747 

Champaign, IL 61820 

You'll be glad you did! 



DON'T FEAR THE TAX FORMS! 

If you live in Ontario, TAX-85 is oneoftlie most 
comprehensive, PERSONAL Income Tax 
programs ever written for Commodore systems. 
If you are confused by: T4s, T5s and the many 
other slips, tax rules or tax forms, then TAX-85 
is just for you! 

Tax-85 asks VERY SIMPLE QUESTIONS and 
then makes all the decisions to give your 
MAXIMUM REFUND. It produces completed tax 
forms, on screen or printer, that resemble the 
ohginal. You simply copy the numbers to the pink 
government forms. 

Send $23,75 (includes tax and postage) to: 
-Specify CBM or 064- 

R,W, Dray & Co 

P.O. BOX 1025 

PETERBOROUGH, ONT. 

K9J 7A5 



Super-OS/9* Is Here 



TPUG has implemented the popular 6809 operating 
system OS-9* on the SuperPET. Super-OS/9 greatly 
expands the software availability and the hardware 
capability of the SuperPET while preserving access 
to the Waterloo languages and programs. 

The cost of Super-OS/9 to club members is $210 
(Cdn) (plus $10 shipment/handling Ontario residents 
add 7% PST), which includes the cost of a hardware 
modification that will not affect the normal operation 
of your SuperPET, installation instructions and the 
operating system disks. 

To obtain your copy please send your cheque or 
money order to: 

TPUG 

101 Duncan Mill Rd., Suite G-7 

Don Mills, Ontario 

Canada M3B 1Z3 

What does Super-OS/9 offer? 

• A true disk operating with features found on UNIX* 
systems and on the AMIGA. 

• Multi-tasking and multi-user capability. 

• Hierarchical directory structure with time/date stamps. 

• Programmable file access privileges for increased 
security. 

Extensive software is available for OS-9, most 
of which runs on Super-OS/9. 



Super-OS/9 VI. 1 includes an assembler, editor, 
symbolic debugger, communication software and ter- 
minal emulation package. Available languages include 
BASIC09, CIS COBOL, Fortran 77, Pascal, Lisp. C 
and others. Application software include wordproces- 
sors, spelling checkers, data bases and spread sheet 
programs. 

TPUG has acquired public domain software and 
will assist users in the conversion of commercial soft- 
ware to Commodore format. 

Portability and Expandability 

• Super-OS/9 programs will run on all OS-9 based 
computers (like the CoCo). 

• Super-OS/9 will support standard disk drives (IBM 
format) and the Hi-res graphics board (700 x 300 dots). 

• Super-OS/9 software is C compatible with OS-9 68k 
and AT&T Unix system V. 

For further information call TPUG Inc. at 
(416) 445-4524, ask for Bruce. 

NOTE: If you own a 3 board SuperPET and wish to 
acquire Super-OS/9, please call TPUG before, order- 
ing Super-OS/9, for info about a hardware fix to a 
design error in your SuperPET computer. 

Super-OS/9 is a trade mark of TPUG and Avygdor Moise. 
OS-9 is a trademark of Microware and Motorola. 
UNIX is a trade mark of Bell Laboratories. 



Expand 

Past 
Maximum 
Capacity! 




At better book stores everywhere! Or 6 issues delivered to your door 

for just $15.00 {Overseas $21 U.S. Air Mail S40 U.S.) 

The Transactor. 500 Steeles Ave. Milton. Ontario. L9T 3P7. 

416 878-8438 

Also check out The Transactor Disk and The Complete Commodore 

Inner Space Anthology ■ to us. expansion knows no limits! 



C64 +C128 

Provincial 
Payroll 

A coinplete Canadian Payroll 
System for Small Business. 

• 50 employees per disk (1541) 

• Calculate and Print Journals 

• Print Cheques 

• Calculate subnsissions summary 
for Revenue Canada 

• Accumulates data and prints T4s 

• Also available for 4032, 8032, 

PC-10 Commodore computers 
Fully Supported 
Available from your Commodore dealer 



Oislrlbuled by: 



ICROCOMPUTER SOLUTIONS 

170 The Don way West, Suite 401 
Don Mills, Ontario M3B2G3 
Tel: (416) 447-4811 













10% DISCOUNT 
TO TPUG MEMBERS 4 

ON SOtTWABE, BOOKS «ND SCCESSORIES 
{EKClUtHNOSAUSlTtMSI 
PHONE DRUE RS*CC[PTED 
VISA/MDSTERCAHO AWEI 

(416)633-5605 
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TPUG Magazine 
Distributors 

Dealers: If you woidd like to carry TPUG Magazine in 

your store, you may order from any one of the foUowing 
distributors: 

CANADA 

Compuiit Distributors, Port Coquitlam, BC 604-464-1221 

USA 

Prairie News, Chicago, IL 312-384-5350 

Levity Distributors, North Hollywood, CA 818-506-7958 

Whole Life Distributors, Englewood, CO 303-761-2435 

M-6 Distribution, Houston, TX 713-778-3002 

The Homing Pigeon, Elgin, TX 512-276-7962 

Northeast News Distributors, Kingston, NY 914-382-2000 

Fred Bay News Co., Portland, OR 503-228-0251 

Alonso Book & Periodical, Alexandria, VA 703-765-1211 

Cornucopia Distribution, Seattle, WA 206-323-6247 

Guild News, Atlanta, GA 404-252-4166 

Micro-PACE, Champaign, IL 800-362-9653 

Nelson News 4651 F Street, Omaha, NE 68127 

Summit City News, Ft. Wayne, IN 219/484-0571 

Total Circulation, South Hackensack, NJ 201/342-6334 
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TPUG OFFICE 416/445-4524 


TPUG BBS 416/273-6300 


TPUG MEETINGS INFO 416/445-9040 
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Sysop (voice, weekdays) Sylvia Gallus 


c/o 416/896-1446 


distant Sysop 


Steve Punter 
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ELECROreC^ 2001 

AN AUTHORIZED COMMODORE SYSTEM DEALER SINCE 1979 

FRIENDLY SERVICE FROM FRIENDLY FACES. 

THIS MONTH ONLY — 15% OFF ALL 

REGULAR PRICED SOFTWARE, ACCESSORIES 

AND MAGAZINES TO TPUG MEMBERS. 



NEW IN STOCK NOW 
1670 MODEM 
1200 BAUD 

FOR YOUR COMMODORE 64 - THIS MONTH'S SPECIALS 



SIDEWAYS 
FOR C-64 

$39.95 



THE 
A/1 AM ACER 

C-64 
$19.95 



IMAGE 
MAKER 

MPS 802 
HIGH RES. 
PRINTING 

$10.00 



OUBLIETTE 

$14.95 



SPRINT 
PRINT 

FULL SPOOLING 
PRINTER BUFFER 



PmcE$29.95 








The complete guide 

to the 1541 
operaling syslem. 

$21.95 




$36.95 



PaperClip 

(the word processor) 




with SpellPack 
S89.95 



Boss 

Joystick 




$21.95 



Kraft 
Joystick 




/I 



$15.95 



CompuServe 

Starter 

Kit 

$39.95 



PRICES IN EFFECT UNTIL APRIL 30, 1 986 



ELcCROnK^ 2001 LTD. 



Name 

Address 



U Checker money order enclosed -. Visa U MasterCard 1~ Amex 
Accl,# Exp Date Signature 



axCRorec^ 2001 ltd. 

5529 Yonge Street, Willowdale, Ontario M2N 5S3 

Tel: (416)229-2700 

Note: All prices In Canadian Funds. Phone and mall orders welcome. 

Ontario residents add 7^ sales tax. 

Add 5% for stiipping (minimum charge $2.0{)) 

■B.: «B ^aijfci 10%dlscount for TPUG members on regular 

^ " "" '•*' priced software, accessories and magazines. 




Number 
One in 

Commodore Coverage! * 

Ahoy! 

Ion International 

S2.50 ••••- 

Monthly publication devoted to Commodore computing. Ahoy! seems to fluctuate from issue to issue, 
but seems recently to be pulling ahead of Run and Computers Gazette in content and style. Of the 
3 'big names,' I would recommend this one most. ( — B.D.) 

Computers Gazette 

Compute Publications 

52.95 ••• + 

for: C-64 
Slick monthly publication with coverage of Commodore's VIC-IO, 64, Plus/4, and newer computers. 
Emphasis is on type-in games and occasional utilities. Reviews are generally candy-coated but rea- 
sonably current. Well-illustrated and laid-out. Goes with the flow, avoiding controversy and originality. 
Features a good selection of advertising. ( — B.D.) 

RUN 

CW Communications 

S2.95 •••-!- 

for: C-64, C-128 
This slicl< monthly Commodore magazine Is chock-full of ads, lots of color and photos, occasional 
decent articles. Reviews are often out of date and, worse, not to be trusted. What can you say about 
a supposedly knowledgeable publication that prints shameless gushing praise for a turkey like the 
PLUS/4 month after month. Best features: MAGIC column, and STRASMA's 'Commodore Clinic' (—B.D.) 



In its September-October '85 issue, INFO (formerly //VFO 64] Magazine reviewed all the major Commodore-spe- 
cific publications. None received a higher rating than Ahoy! 

Our review is reprinted here. In the interest of fairness, we've also reprinted the reviews of the other two 
members of the 'Big Three— all three reviews word-for-word, exactly as they appeared in INFO Magazine. 

We thank INFO Publisher Benn Dunnington for covering our segment of the marketplace in his usual hard-hit- 
ting style. And we'll try to stop fluauating! 

*Source: INFO Magazine, September-October '85 



